For the analysis, we need to measure the fitness of our design decisions and show where the best location for the openings in the roof are. We will be using Ladybug to understand the amount of sunlight that comes through the openings to the deck below. Briefly, we'll go through the Ladybug setup, but please reference the TOIPedia article about using Ladybug  with Galapagos for more detailed information.  

At the beginning, we will have our standard EPW file setup, which includes the URL, the Ladybug download weather component, and the Ladybug Import EPW. You will also need to set up the Ladybug analysis period, and this is something that you can adjust based on the analysis that you would like to complete. The location from the Import EPW component will be connected into the Ladybug Sun Path component.  

Here you can also adjust the angle to north if necessary based on how you drew your geometry, the scale of the sun path, and the projection of it. We will be using the Ladybug direct sun hours component. Connect the vectors output from the Ladybug sun path component into the vectors input from  the Ladybug direct sun hours component. Make sure to flatten this input.  

We also can specify a grid size. In our case, we can start with 700. You can choose whether you would like to use multicore processing to run the component if you have very large surfaces that you're going to be calculating. And don't forget to connect a Boolean value to the run input of the component.  

The results of the Ladybug direct sun hours will give us the number of hours of sunlight at each grid point, so we can use the Mass Edition component, which we connect to the results to get the total number of hours. We can connect this with our existing geometry to complete the analysis setup.  

Since Ladybug will need the context, add an additional surface component and label this context. With this component, we will select the walls around the site. Right click the component and set multiple surfaces then select the walls around the courtyard. These walls, in addition to our rooftop, will be casting the shadows onto the terraces below.  

We can use the entwine component and combine the geometry into one list, connect the roof geometry to one, and connect the context surface geometry to zero. Now, if we turn off the preview for the other two components, we can see that our roof and our walls are combined into one list. This will be the context that Ladybug will need. Connect the entwined into the context input. Ensure this input is being flattened.  

Finally we need to connect the geometry which will be analysed, which will be the terraces. Go back to the surface, which we linked earlier and connect the terrace geometry to the geometry input. As we can see, Ladybug ran but we notice that something strange is happening because although there should be sun hitting these terraces, we see that Ladybug reports 0 hours. This is a problem that can occur which relates to the normal of your surface. What you can do it shows the surfaces in Rhino and flip the surface. Now we can see the analysis. So the normal of our surface was facing down before so Ladybug wasn't able to analyse the surface. We can do the same for the other surface and see that it now show the correct number of hours. Now that the analysis is working, we can see the grid size is too large so we can increase the grid size. Decrease the grid to 100, the calculation still runs relatively fast but give us more detailed results.