Please enable JavaScript to view this site.

The SAM CSV Format for Wind is a comma-delimited text format for SAM's wind power performance model. This is the format for files from the NREL WIND Toolkit API and NREL RE Explorer.

Notes.
 
SAM 2022.11.21 r1 is the first version of SAM to support this new format. We are transitioning away from the SRW format to this format to make SAM more compatible with the WIND Toolkit API and NREL RE Explorer.
 
Some WIND Toolkit endpoints return files in a slightly different format. For example, offshore-hawaii-download and offshore-mid-atlantic-download are in a different format than the one described here.

SS_WindResource-samcsv

The format allows you to use wind resource data at one or more heights above the ground, and is designed to be flexible enough to handle a range of data. To work with SAM's Wind Power model, the file must meet the following requirements:

The file stores four data types: wind speed, wind direction, air temperature, and atmospheric pressure.

The file must contain a least one complete set of the four data types.

The data can be for one measurement height above the ground or multiple heights.

The measurement heights can be different for the different types of data.

oAir temperature, atmospheric pressure, and wind direction data can be at one height with wind speed data at multiple heights.

oThe direction measurement height must be within 10 meters of the nearest wind speed measurement height.

The file must contain a wind speed measurement height within 35 meters of the turbine hub height.

The file must contain data for a single year.

The Wind Power model determines the simulation time step from the number of resource data rows in the weather file, so time stamps are not required.

oThe first row of data is in the hour ending at 1 a.m on January 1 local time.

oThe number of data rows must be an integer multiple of 8760 hours/year.

oTime steps can be hourly or subhourly.

SAM requires a valid value for all time steps for each data element. It does not fill data gaps. It does perform some checks on the weather data before running a simulation, and displays messages about problems with the data in the simulation notices.

Header Row 1

The first row of the file stores information about the location as a label/value pair, separated by commas: Each label is followed by its value. The label/value pairs can be in any order.

Required header items are:

Latitude

Longitude

Site Timezone

Data Timezone

Optional items are:

Elevation

SiteID

Row 1 Notes.
 
If elevation data is not provided in the weather file, SAM's Wind Power model sets it to zero. If your weather file does not include elevation data, you can add it by editing the file and adding it to Row 1. The elevation data is used when you choose the Define turbine design characteristics option on the Wind Turbine page to calculate the turbine power curve from design parameters. SAM uses the air temperature and atmospheric pressure data for each time step to adjust the turbine power curve. It does not use the elevation above sea level for this purpose. If you are using the Select a turbine from the library option, SAM does not use the elevation value from the weather file.
 
The site time zone and data time zone values must be the same. SAM assumes that the time stamps in the resource data rows are in local time.
 
Row 1 items can be in any order, but the each item's value must immediately follow its label.

Here is an example of a valid Row 1:

SiteID,2226728,Site Timezone,-5,Data Timezone,-5,Longitude,-78.5,Latitude,32.1,Elevation,0

Example of a valid Row 1 with only required data:

Site Timezone,-5,Data Timezone,-5,Longitude,-78.5,Latitude,32.1

Header Field

Units

Description (Examples)

Accepted Labels for Row 1

Latitude

degrees

Latitude of the site (32.1, -20.6)

latitude, lat

Longitude

degrees

Longitude of the site (-78.5, 35.1)

longitude, lon, long ,lng

Site timezone

hours offset from UTC

Time zone of the site (-8, 5)

site timezone

Data timezone

hours offset from UTC

Time zone of the data time stamps in each row. Must be equal to the site time zone. (-8, 5)

data timezone

Elevation

meters above sea level

Site elevation above sea level in meters. (900, 1235.6)

el, elev, elevation, site elevation

SiteID

n/a

Text description of the site or data. SAM does not use this information. (2226728, Site Name)

siteid, id, location, location id, station, station id, wban, wban#

Header Row 2

SAM determines the type of data for each column based on the labels in Row 2. Row 2 must have the same number of columns as the resource data rows.

Row 2 must contain at least one column label for wind speed, wind direction, ambient temperature, and atmospheric pressure. For a weather file with data at more than one height above the ground, Row 2 must contain a set of columns for each height.

Required columns are:

wind speed for at least one height above the ground

wind direction for at least one height above the ground

temperature for at least one height above the ground

atmospheric pressure for at least one height above the ground

Row 2 Notes.
 
Columns do not have to be in any particular order, and can be in a different order for each hub height.
 
Columns can be for data that SAM does not use. SAM ignores any column labels it does not recognize.
 
SAM's wind power model does not require year, month, day, or minute time stamps. It ignores any time stamp data in the file.

Example of a valid Row 2 for a file with data at two measurement heights:

air pressure at 100m (Pa),air pressure at 200m (Pa),wind speed at 100m (m/s),wind speed at 200m (m/s),wind direction at 100m (deg),wind direction at 200m (deg),,air temperature at 100m (C),air temperature at 200m (C)

Data Field

Units

Accepted Labels for Row 2

Wind speed

m/s

must contain "speed"

Wind direction

degrees east of north (degrees), with zero degrees indicating wind from the north, and 90 degrees indicating wind from the east

must contain "dir"

Atmospheric pressure

atm or Pa (SAM's Wind Power model assumes values greater than 1.1 are in Pa and converts them to atm)

must contain "pres"

Ambient temperature

°C

must contain "temp"

Data Rows 3 and higher

The data rows must contain columns of wind resource data in the order defined by the labels in Row 2.

SAM's wind power model assumes the data are in the units described in the table above. It does not read units from the column labels.

System Advisor Model (SAM) Help © National Renewable Energy Laboratory

  

Keyboard Navigation

F7 for caret browsing
Hold ALT and press letter

This Info: ALT+q
Page Header: ALT+h
Topic Header: ALT+t
Topic Body: ALT+b
Contents: ALT+c
Search: ALT+s
Exit Menu/Up: ESC