Grasshopper

algorithmic modeling for Rhino

0 | Ladybug
1 | AnalyzeWeatherData
2 | VisualizeWeatherData
3 | EnvironmentalAnalysis
4 | Renewables
5 | Extra
6 | Developers
7 | WIP

Wind Boundary Profile

Component Index > Ladybug > 2 | VisualizeWeatherData > Wind Boundary Profile

Use this component to visualize a wind profile curve for a given terrain type. Wind speed increases as one leaves the ground and wind profiles are a means of visualizing this change in wind speed with height.
The wind profile will point you in the direction of prevailing wind if EPW data is connected to _windSpeed_tenMeters and windDirections_. In case you are trying to orient your building to take advantage of natural ventilation, as a good rule of thumb, it always a good strategy to align the shorter axis of your building parellel to the prevailing wind directions.
More information on the power law of the wind profile can be found here: http://en.wikipedia.org/wiki/Wind_profile_power_law

Inputs

NameIDDescriptionType
north_north_Input a vector to be used as a true North direction for the sun path or a number between 0 and 360 that represents the degrees off from the y-axis to make North. The default North direction is set to the Y-axis (0 degrees).Goo
_windSpeed_tenMeters_windSpeed_tenMetersThe wind speed from the import EPW component or a number representing the wind speed at 10 meters off the ground. If this value is input without a corresponding wind direction below, the profile will be drawn with the average of the speed input here. If corresponding values are connected to the windDirection, the speed on the profile will be the average speed of the prevailing wind direction.Goo
windDirection_windDirection_An optional number representing the degrees from north of the wind direction. This can also be the windDirection output from the import EPW component. This direction will be used to orient the wind profile in 3 dimensions to the direction of the prevailing wind.Goo
terrainType_terrainType_An interger or text string that sets the terrain class associated with the output windSpeedAtHeight. Interger values represent the following terrain classes: 0 = City: large city centres, 50% of buildings above 21m over a distance of at least 2000m upwind. 1 = Suburban: suburbs, wooded areas. 2 = Country: open, with scattered objects generally less than 10m high. 3 = Water: Flat, unobstructed areas exposed to wind flowing over a large water body (no more than 500m inland).Goo
epwTerrain_epwTerrain_An interger or text string that sets the terrain class associated with the output windSpeedAtHeight. The default is set to 2 for flat clear land, which is typical for most EPW files that are recorded at airports. Interger values represent the following terrain classes: 0 = City: large city centres, 50% of buildings above 21m over a distance of at least 2000m upwind. 1 = Suburban: suburbs, wooded areas. 2 = Country: open, with scattered objects generally less than 10m high. 3 = Water: Flat, unobstructed areas exposed to wind flowing over a large water body (no more than 500m inland).Goo
powerOrLog_powerOrLog_Set to "True" to use a power law to translate the wind speed to that at a given height and set to "False" to use a log law to translate the wind speed. The default is set to "True" for a power law as this is the function that is used by EnergyPlus.Goo
--------------------------------------------------...Goo
HOY_HOY_Use this input to select out specific indices of a list of values connected for wind speed and wind direction. If you have connected hourly EPW data, this is the equivalent of a "HOY" input and you can use the "Ladybug_DOY_HOY" component to select out a specific hour and date. Note that this overrides the analysisPeriod_ input below.Goo
analysisPeriod_analysisPeriod_If you have connected data from an EPW component, plug in an analysis period from the Ladybug_Analysis Period component to calculate data for just a portion of the year. The default is Jan 1st 00:00 - Dec 31st 24:00, the entire year.Goo
annualHourlyData_annualHourlyData_An optional list of hourly data from the Import epw component, which will be overlaid on wind rose (e.g. dryBulbTemperature)Goo
conditionalStatement_conditionalStatement_This input allows users to remove data that does not fit specific conditions or criteria from the wind rose. To use this input correctly, hourly data, such as temperature or humidity, must be plugged into the annualHourlyData_ input. The conditional statement input here should be a valid condition statement in Python, such as "a>25" or "b<80" (without quotation marks). The current version of this component accepts "and" and "or" operators. To visualize the hourly data, only lowercase English letters should be used as variables, and each letter alphabetically corresponds to each of the lists (in their respective order): "a" always represents the 1st list, "b" always represents the 2nd list, etc. For the WindBoundaryProfile component, the variable "a" always represents windSpeed. For example, if you have hourly dry bulb temperature connected as the second list, and relative humidity connected as the third list (both to the annualHourlyData_ input), and you want to plot the data for the time period when temperature is between 18C and 23C, and humidity is less than 80%, the conditional statement should be written as “18Goo
originPt_originPt_An optional point that can be used to change the base point at shich the wind profile curves are generated. By default, the wond profile curves generate at the Rhino model origin.Goo
windVectorScale_windVectorScale_An optional number that can be used to change the scale of the wind vectors in relation to the height of the wind profile curve. The default is set to 5 so that it is easier to see how the wind speed is changing with height.Goo
windProfileHeight_windProfileHeight_An optional number in rc model units that can be used to change the height of the wind profile curve. By default, the height of the curve is set to 30 meters (or the equivalent distance in your Rhino model units). You may want to move this number higher or lower depending on the wind effects that you are interested in.Goo
distBetweenVec_distBetweenVec_An optional number in rhino model units that represents the distance between wind vectors in the profile curve. The default is set to 2 meters (or the equivalent distance in your rc model units).Goo
windArrowStyle_windArrowStyle_An optional integer to set the style of the wind vectors. The default is set to 1 for colored arrows. Choose from the following options: 0 = No Wind Arrows - use this option if you do not want to gerenate arrows. 1 = 3D Colored Wind Arrows - use this option to generate arrows as a colored 3D mesh (arrows will be colored based on the magnitude of their wind speed). 2 = High-Res 3D Colored Wind Arrows - use this option to create color arrows just like Option 1 but with a circular cross section and smooth edges. 3 = Colored Line Wind Arrows - use this option to generate arrows as lines with colored tips. 4 = Black Line Wind Arrows - use this option to generate arrows as lines with black tips.Goo
legendPar_legendPar_Optional legend parameters from the Ladybug Legend Parameters component.Goo
bakeIt_bakeIt_An integer that tells the component if/how to bake the bojects in the Rhino scene. The default is set to 0. Choose from the following options: 0 (or False) - No geometry will be baked into the Rhino scene (this is the default). 1 (or True) - The geometry will be baked into the Rhino scene as a colored hatch and Rhino text objects, which facilitates easy export to PDF or vector-editing programs. 2 - The geometry will be baked into the Rhino scene as colored meshes, which is useful for recording the results of paramteric runs as light Rhino geometry.Goo

Outputs

NameIDDescriptionType
outreadMe!...String
----------------------------------------...Goo
windSpeedswindSpeedsThe wind speeds that correspond to the wind vectors in the wind profile visualization.Goo
windVectorswindVectorsThe wind vectors that correspond to those in the wind profile visualization. Note that the magnitude of these vectors will be scaled based on the windVectorScale_ input.Goo
vectorAnchorPtsvectorAnchorPtsAnchor points for each of the vectors above, which correspond to the height above the ground for each of the vectors. Connect this along with the output above to a Grasshopper "Vector Display" component to see the vectors as a grasshopper vector display (as opposed to the vector mesh below).Goo
----------------------------------------Script variable PythonGoo
windVectorMeshwindVectorMeshA mesh displaying the wind vectors that were used to make the profile curve.Goo
windProfileCurvewindProfileCurveA curve outlining the wind speed as it changes with height. This may also be a list of wind profile curves if multiple "HOY_" inputs are connected or "averageData_" is set to False."Goo
profileAxesprofileAxesScript variable WindBoundaryProfileGoo
axesTextaxesTextThe meshes of the axes text (labelling wind speeds and heights).Goo
legendlegendA legend of the wind profile curves. Connect this output to a grasshopper "Geo" component in order to preview the legend separately in the rc scene.Goo
legendBasePtlegendBasePtThe legend base point(s), which can be used to move the legend in relation to the wind profile with the grasshopper "move" component.Goo

© 2018   Created by Robin Rodricks and Andrew Heumann.   Hosted by

Badges  |  Report an Issue  |  Terms of Service