Grasshopper Docs

Community documentation for Grasshopper add-ons & plugins

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

Use this component to make a bar chart in the Rhino scene of any monhtly or avrMonthyPerHour climate data or simulation data.
This component can also plot daily or hourly data but, for visualizing this type of data, it is recommended that you use the "Ladybug_3D Chart" component.

Inputs

NameIDDescriptionType
Input Data_inputDataA list of input data to plot. This should usually be data out of the 'Ladybug_Average Data' component or monthly data from an energy simulation but can also be hourly or daily data from the 'Ladybug_Import EPW.' However, it is recommended that you use the 'Ladybug_3D Chart' component for daily or hourly data as this is usually a bit clearer.Goo
Comfort ModelcomfortModel_An optional interger to draw the comfort model on the chart. Choose from the following: 0 - No comfort range 1 - PMV comfort range (indoor) 2 - Adaptive confort range (naturally ventilated) 3 - UTCI Comfort (outdoor) Note that this option is only available when temperature is connected so, by default, it is set to 0 for no comfort range.Goo
Bldg Balance PtbldgBalancePt_An optional float value to represent the outdoor temperature at which the energy passively flowing into a building is equal to that flowing out of the building. This is usually a number that is well below the comfort temperture (~ 12C - 18C) since the internal heat of a building and its insulation keep the interior warmer then the exterior. However, by default, this is set to 23.5C for fully outdoor conditions.Goo
Stack ValuesstackValues_Set to 'True' if you have multiple connected monthly or daily _inputData with the same units and want them to be drawn as bars stacked on top of each other. Otherwise, all bars for monthly/daily data will be placed next to each other. The default is set to 'False' to have these bars placed next to each other.Goo
Plot From ZeroplotFromZero_Set to 'True' to have the component plot all bar values starting from zero (as opposed from the bottom of the chart, which might be a negative number). This is useful when you are plotting the terms of an energy balance where you want gains to be above zero and losses to be below. It can be detrimental if you are plotting temperatures in degrees celcius and do not want negative values to go below zero. As such, the default is set to 'False' to not plot from zero.Goo
Alt TitlealtTitle_An optional text string to replace the default title of the chart of the chart. The default is set to pick out the location of the data connected to 'inputData.'Goo
Alt YAxis TitlealtYAxisTitle_An optional text string to replace the default Y-Axis label of the chart. This can also be a list of 2 y-axis titles if there are two different types of data connected to _inputData. The default is set to pick out the names of the first (and possibly the second) list connected to the 'inputData.'Goo
Base Point_basePoint_An optional point with which to locate the 3D chart in the Rhino Model. The default is set to the Rhino origin at (0,0,0).Goo
X Scale_xScale_The scale of the X axis of the graph. The default is set to 1 and this will plot the X axis with a length of 120 Rhino model units (for 12 months of the year).Goo
Y Scale_yScale_The scale of the Y axis of the graph. The default is set to 1 and this will plot the Y axis with a length of 50 Rhino model units.Goo
Label Pts Offset_labelPtsOffset_A number in Rhino model units that represents the distance between the top of bars on the chart and the location where the dataLabelPts are. If you set this value to 0, you can use the dataLabelPts to create a polyline of monthly values. The default is autocalculated based on the scale of the chart.Goo
Legend ParlegendPar_Optional legend parameters from the Ladybug Legend Parameters component.Goo
Bake ItbakeIt_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
Data MeshdataMeshA series of meshes that represent the different monthly (or daily) input data. Multiple lists of meshes will be output for several input data streams.Goo
Data CurvesdataCurvesA list of curves that represent the different avrMonthyPerHour and hourly input data. Multiple lists of curves will be output for several input data streams.Goo
Data Crv ColorsdataCrvColorsA list of colors that correspond to the dataCurves above. Hook this up to the 'swatch' input of the native Grasshopper 'Preview' component and the curves above up to the 'geometry input to preview the curves with their repective color.Goo
Graph AxesgraphAxesA list of curves representing the axes of the chart.Goo
Graph LabelsgraphLabelsA list of text meshes representing the time periods corresponding to the input dataGoo
TitletitleA title for the chart. By default, this is just the location of the data but you can input a custom title with the altTitle_ input.Goo
Title Base PttitleBasePtThe title base point, which can be used to move the title in relation to the chart with the grasshopper "move" component.Goo
LegendlegendA legend of the chart that tells what each connected data stram's color is. Connect this output to a grasshopper "Geo" component in order to preview the legend in the Rhino scene.Goo
Legend Base PtlegendBasePtThe legend base point, which can be used to move the legend in relation to the chart with the grasshopper "move" component.Goo
Data Label PtsdataLabelPtsA series of points that mark where each of the bars or lines of the chart lie. You can use this to label the bars or lines with numerical values using a native grasshopper "text tag" component and the data that you have connected to the _inputData of this component.Goo
Comfort BandcomfortBandA series of meshes that represent the comfort range in each month according to the input comfortModel_.Goo
Comfort LegendcomfortLegendA legend for the comfort model. This legend will only be provided if temperature is fed to this component and the value provided to the comfortModel_ is either 1, 2, or 3.Goo

Video Tutorials

Site design © Robin Rodricks.   Co-created by Andrew Heumann.   Ladybug and associated data © 2020 Ladybug Tools.  
Rhinoceros and Grasshopper are registered trademarks of Robert McNeel & Associates.  Hosted by GitHub

Report an Issue  |  Terms of Service