# Hourly Plot

![](https://894783789-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LPHXQ1I3gb93zpLrLZf%2Fuploads%2Fgit-blob-1aaba4f5d2bdce6c34c04a781be8d704e342954b%2FHourly_Plot.png?alt=media)

![](https://894783789-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LPHXQ1I3gb93zpLrLZf%2Fuploads%2Fgit-blob-a9d5c8785374b5b6e28ec6d80148e618a6edb096%2FHourly_Plot.png?alt=media) - [\[source code\]](https://github.com/ladybug-tools/ladybug-grasshopper/blob/master/ladybug_grasshopper/src/LB%20Hourly%20Plot.py)

Create a colored plot of any hourly data collection.

### Inputs

* **data \[Required]**

A HourlyContinuousCollection or HourlyDiscontinuousCollection which will be used to generate the hourly plot.

* **base\_pt**

An optional Point3D to be used as a starting point to generate the geometry of the plot (Default: (0, 0, 0)).

* **x\_dim**

A number to set the X dimension of the mesh cells (Default: 1 meters).

* **y\_dim**

A number to set the Y dimension of the mesh cells (Default: 4 meters).

* **z\_dim**

A number to set the Z dimension of the entire chart. This will be used to make the colored\_mesh3d of the chart vary in the Z dimension according to the data. The value input here should usually be several times larger than the x\_dim or y\_dim in order to be noticable (e.g. 100). If 0, the colored\_mesh3d will simply be flat. (Default: 0).

* **reverse\_y**

Boolean to note whether the Y-axis of the chart is reversed If True, time over the course of the day will flow from the top of the chart to the bottom instead of the bottom to the top.

* **clock\_24**

Boolean to note whether the hour labels on the Y-Axis of the chart should be in 24-hour clock format (eg. 18:00) or they should be in 12-hour clock format (eg. 6PM).

* **legend\_par**

An optional LegendParameter object to change the display of the HourlyPlot. This can also be a list of legend parameters to be applied to the different connected \_data.

* **statement**

A conditional statement as a string (e.g. a > 25). The variable of the first data collection should always be named 'a' (without quotations), the variable of the second list should be named 'b', and so on. For example, if three data collections are connected to \_data and the following statement is applied: '18 < a < 26 and b < 80 and c > 2' The resulting collections will only include values where the first data collection is between 18 and 26, the second collection is less than 80 and the third collection is greater than 2.

* **period**

A Ladybug analysis period to be applied to all of the input \_data.

### Outputs

* **report**

...

* **mesh**

A colored mesh derived from the input \_data. Multiple meshes will be output for several data collections are input.

* **legend**

Geometry representing the legend for each mesh.

* **borders**

A list of lines and polylines representing different time intervals of the plot.

* **labels**

A list of text objects that label the borders with the time intervals that they demarcate.

* **title**

A text object for the global\_title.

* **vis\_set**

An object containing VisualizationSet arguments for drawing a detailed version of the Hourly Plot in the Rhino scene. This can be connected to the "LB Preview Visualization Set" component to display this version of the Hourly Plot in Rhino.