# Import NOAA File

![](/files/-Mihrccid_v-UTePgRai)

![](/files/-MihraPn0nQfn06uAA_l) - [\[source code\]](https://github.com/ladybug-tools/dragonfly-grasshopper/blob/master/dragonfly_grasshopper/src//DF%20Import%20NOAA%20File.py)

Import climate data from a .csv file of annual data obtained from the National Oceanic and Atmospheric Administration (NOAA) database. The database can be accessed here: <https://gis.ncdc.noaa.gov/maps/ncei/cdo/hourly>

## Inputs

* **noaa\_file \[Required]**

  The path to a .csv file of annual data obtained from the NOAA database on your system as a string.&#x20;
* **time\_zone**

  Optional time zone for the station.  If blank, a default time zone will be estimated from the longitude.&#x20;
* **timestep**

  Integer forthe timestep at which the data collections should be output. Data in the .csv that does not conform to this timestep will be ignored in the output data collections. This can be set as high as 60 to ensure that all data from the .csv file is imported. However, such large data collections can be time consuming to edit. (Default: 1).&#x20;
* **run \[Required]**

  Set to True to run the component and import the data.&#x20;

## Outputs

* **location**

  Script variable ImportNOAA&#x20;
* **dry\_bulb\_temp**

  The houlry dry bulb temperature, in C. Note that this is a full numeric field (i.e. 23.6) and not an integer representation with tenths. Valid values range from 70 C to 70 C. Missing value for this field is 99.9.&#x20;
* **dew\_point\_temp**

  The hourly dew point temperature, in C. Note that this is a full numeric field (i.e. 23.6) and not an integer representation with tenths. Valid values range from 70 C to 70 C. Missing value for this field is 99.9.&#x20;
* **wind\_speed**

  The hourly wind speed in m/sec. Values can range from 0 to 40. Missing value is 999.&#x20;
* **wind\_direction**

  The hourly wind direction in degrees. The convention is that North=0.0, East=90.0, South=180.0, West=270.0. (If wind is calm for the given hour, the direction equals zero.) Values can range from 0 to 360. Missing value is 999.&#x20;
* **total\_sky\_cover**

  The fraction for total sky cover (tenths of coverage). (i.e. 1 is 1/10 covered. 10 is total coverage) (Amount of sky dome in tenths covered by clouds or obscuring phenomena at the hour indicated at the time indicated.) Minimum value is 0; maximum value is 10; missing value is 99."&#x20;
* **atmos\_pressure**

  The hourly weather station pressure in Pa. Valid values range from 31,000 to 120,000... Missing value for this field is 999999."&#x20;
* **visibility**

  This is the value for visibility in km. (Horizontal visibilitY). It is not currently used in EnergyPlus calculations. Missing value is 9999.&#x20;
* **ceiling\_height**

  Script output ceiling\_height.&#x20;
* **model\_year**

  The year from which the hourly data has been extracted. Note that, for this component to run correclty, all of the data in the text file must be from a single year.&#x20;


---

# 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/dragonfly-primer/components/6_alternativeweather/import_noaa_file.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.
