# Hourly Plot

![](/files/Inx4l3OXUxZUfvBc5hF1)

![](/files/-Mihijw_fxEW2Y7aBY6Q) - [\[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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ladybug.tools/ladybug-primer/components/2_visualizedata/hourly_plot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.