# Import STAT

![](/files/-Mihil-4BLjOGiymXMzw)

![](/files/-MihijsUhJQLAoW6-ELu) - [\[source code\]](https://github.com/ladybug-tools/ladybug-grasshopper/blob/master/ladybug_grasshopper/src//LB%20Import%20STAT.py)

Import data from a standard .stat file.

### Inputs

* **stat\_file \[Required]**

A .stat file path on your system as a string.

### Outputs

* **location**

A Ladybug Location object describing the location data in the STAT file.

* **ashrae\_zone**

The ASHRAE climate zone of the STAT file. Numbers in the zone denote average temperature (0 = Hottest; 8 = Coldest). Letters in the zone denote wetness (A = Humid; B = Dry; C = Marine)

* **koppen\_zone**

The Koppen climate zone of the STAT file. The Koppen climate system uses vegetation as in indicator fo climate and combines average monthly temperatures, precipitation, and the seasonality of precipitation.

* **clear\_dir\_norm\_rad**

The hourly "Clear Sky" Direct Normal Radiation in Wh/m2. Such clear sky radiation is typically used for sizing cooling systems. If monthly optical depths are found within the STAT file, these values will come from the Revised ASHARAE Clear Sky (Tau model). If no optical depths are found, they will come from the original ASHARE lear sky model.

* **clear\_diff\_horiz\_rad**

The hourly "Clear Sky" Diffuse Horizontal Radiation in Wh/m2. Such clear sky radiation is typically used for sizing cooling systems. If monthly optical depths are found within the STAT file, these values will come from the Revised ASHARAE Clear Sky (Tau model). If no optical depths are found, they will come from the original ASHARE lear sky model.

* **ann\_heat\_dday\_996**

A DesignDay object representing the annual 99.6% heating design day.

* **ann\_heat\_dday\_990**

A DesignDay object representing the annual 99.0% heating design day.

* **ann\_cool\_dday\_004**

A DesignDay object representing the annual 0.4% cooling design day.

* **ann\_cool\_dday\_010**

A DesignDay object representing the annual 1.0% cooling design day.

* **monthly\_ddays\_050**

A list of 12 DesignDay objects representing monthly 5.0% cooling design days.

* **monthly\_ddays\_100**

A list of 12 DesignDay objects representing monthly 10.0% cooling design days.

* **extreme\_cold\_week**

A Ladybug AnalysisPeriod object representing the coldest week within the corresponding EPW.

* **extreme\_hot\_week**

A Ladybug AnalysisPeriod object representing the hottest week within the corresponding EPW.

* **typical\_weeks**

A list of Ladybug AnalysisPeriod objects representing typical weeks within the corresponding EPW. The type of week can vary depending on the climate. For mid and high lattitude climates with 4 seasons (eg. New York), these weeks are for each of the 4 seasons ordered as follows: Winter, Spring, Summer, Autumn For low lattitude climates with wet/dry seasons (eg. Mumbai), these weeks might also include: Wet Season, Dry Season For equitorial climates with no seasons (eg. Singapore), This output is usually a single week representing typical conditions of the entire year.


---

# 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/0_import/import_stat.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.
