Orientation Study

I recently received multiple questions about the orientation study and I hope this discussion answers the majority of them.

WHAT + WHEN?

Orientation study is a feature integrated to the analysis components (radiation, sunlight-hours and view analysis) which let you study the effect of the orientation of your building and the analysis result. When you come to a question similar to "what is the orientation that the building receives the most/least amount of radiation?" is probably the right time to use this component.

HOW?

I'll try to explain the steps using a simple example. Here is my design geometries. The building in the center is the building to be designed and the rest of the buildings are context. I want to see the effect of orientation on the amount of the radiation on the test building surfaces from the start of Oct. to the end of Feb. for Chicago.

First I need to set up the normal radiation analysis and run it for the building as it is right now. [I'm not going to explain how you can set up this since you can find it in the sample file (Download the sample file from here)]

Now I need to set up the parameters for orientation study using orientationStudyPar component. You can find it under the Extra tab:

At minimum I need to input the divisionAngle, and the totalAngle and set runTheStudy to True. In this case I put 45 for divisionAngle and 180 for the totalAngle which means I want the study to be run for angles 0, 45, 90, 135 and 180.

[Note1: The divisionAngle should be divisible by totalAngle.]

[Note 2: If you don't provide any point for the basePoint, the component will use the center of the geometry as the center of the rotation.]

[Note 3: You can also rotate the context with the geometry! Normally you don't have the chance to change the context to make your design work but if you got lucky the rotateContext input is for you! Set it to True. The default is set to False.]

You're all set for the orientation study, just connect the orientationStudyPar output to OrientationStudyP input in the component and wait for the result!

The component will run the study for all the orientations and preview the latest geometry. To see the result just grab a quick graph and connect it to totalRadiation. As you can see in the graph 135 is the orientation that I receive the maximum radiation. Dang!

If you want to see all the result geometries set bakeIt to True, and the result will be baked under LadyBug> RadaitionStudy>[projectname]> . The layer name starts with a number which is the totalRadiation.

Mostapha

Attachments:

orientationStudy_SampleFile.gh, 67 KB

Replies are closed for this discussion.

Replies to This Discussion

Permalink Reply by Mostapha Sadeghipour Roudsari on March 8, 2015 at 7:07pm

Hi Leonardo, I'm taking a look at this. It looks like a bug.

Permalink Reply by Mostapha Sadeghipour Roudsari on March 8, 2015 at 8:50pm

Leonardo, Check the attached file. It is fixed now.

Attachments:

orientationStudy_fixed.gh, 364 KB

Permalink Reply by Leonardo Roli on March 9, 2015 at 7:29am

Now it works perfectly! Thank you indeed Mostapha :D

Permalink Reply by Mostapha Sadeghipour Roudsari on March 26, 2015 at 9:51pm

Hi Paul. You are right. SunlightHours analysis should have the same issue and also the view analysis component. Here is the changes:

https://github.com/mostaphaRoudsari/ladybug/commit/8190ecb63e930663...

It would be great if you can get it fixed and send a pull request on github.

Permalink Reply by Mostapha Sadeghipour Roudsari on April 4, 2015 at 4:34pm

Hi Paul,

I fixed the bug. We only update the files on food4Rhino for every release so you need to download it from github (or use update component).

Back to your question for each surface, the results are grafted for each input surface. So if you already break the test surfaces for each room you only need to average the results and you will have a single number for each. You can match them with original input surfaces or use "analysisMesh" output which is unjoined meshes.

I hope it helps,

Mostapha

Permalink Reply by Mostapha Sadeghipour Roudsari on April 4, 2015 at 4:37pm

Here is an example:

Permalink Reply by Juan Sepulveda on April 10, 2015 at 5:18am

Hi Mostapha

After updating the code the problem persists when connecting the Orientation Study component:

Runtime error (UnboundNameException): global name 'legenPar' is not defined
Traceback:
line 364, in main, "<string>"
line 446, in script

do you think I'm making something wrong? thanks,

Juan

Permalink Reply by Juan Sepulveda on April 10, 2015 at 5:34am

*it is solved if I disconnect the LegendParameters component, but still a minor bug, thank you.

Permalink Reply by Mostapha Sadeghipour Roudsari on April 10, 2015 at 7:22am

Hi Juan. Thanks for reporting. I added and issue (https://github.com/mostaphaRoudsari/ladybug/issues/144). We will check this soon.

Permalink Reply by Mostapha Sadeghipour Roudsari on August 23, 2015 at 9:14am

Hi Paul. It's indeed possible and sounds like a good idea. Added to github > https://github.com/mostaphaRoudsari/ladybug/issues/169

Permalink Reply by johnnyUtah05 on February 10, 2016 at 12:42am

Hi,

Love the plugin, but I am getting an error here. (Probably a user error). Anyway, my building is not rotating at all. The yellow surface component is after I attached it so it does not apply here. I attached the definition with the data internalized.

Thank you in advance!

Attachments:

Orientation Error.gh, 373 KB

Permalink Reply by Mostapha Sadeghipour Roudsari on February 11, 2016 at 6:38pm

Hi Erik,

As you can see from totalRadiation output you're getting the results for are the orientations. Ladybug doen't output the rotated geometry. If you set bakeIt to true the result for all the orientations will be saved to Rhino and you can check them separately.

Mostapha