Weather Data

A SAM weather file is a text file that contains one year's worth of data in hourly or subhourly time steps describing the solar resource or wind resource at a particular location. A weather file may contain typical-year data that represents long-term historical data or single-year data for a particular year. The solar resource and meteorological data in a SAM weather file may have been developed from ground measurements, data from a satellite, or a combination of the two.

For more information about weather data for SAM, see the "Weather Data" chapter in SAM's SAM's Help system. The Help system is available in SAM from the software's Help menu, and as a PDF file on the Download page.

Where to find Solar Resource Data to Use with SAM

United States, North and South America, Southern Asia

The NREL National Solar Radiation Database (NSRDB) is the best source of data for locations in the United States, Canada, Central and South America, Sri Lanka, India, Nepal, Bhutan, Bangladesh, and parts of Pakistan, Afghanistan, and Myanmar, and western Southeast Asia.

You can use the Download buttons on SAM's Location and Resource input page to download NSRDB data directly from SAM.

The NSRDB provides access to the latest weather files as both single-year and typical-year files from the latest PSM dataset, and from the legacy TMY2 (MTS1) and TMY3 (MTS2) datasets.

Europe, Africa, Central Asia, Southeast Asia

The European Commission's Photovoltaic Geographical Information System (PVGIS) is a good source that covers Europe, Africa, Central Asia, and parts of Southeast Asia.

Use the PVGIS website to download weather data. For now the best format to use with SAM is the typical-year (TMY) in the EPW format.

To use this data in SAM, after downloading the EPW files to a folder on your computer, on the Location and Resource page, click the Add/remove weather file folders button to add the folder to the list SAM uses to build the solar resource library. The files will then appear in the library where you can select them.


Other Sources of Solar Resource Data

If you know of other data sources to add to this list, please contact us.

The following sources provide free weather data:

Source Region Description
AUSTELA Australia Single-year hourly data (select years between 1996 and 2011). Twelve locations. SAM-ready TMY3 format. Free.
EnergyPlus Global Typical-year hourly data from various sources. Over 2,100 locations. SAM-ready EPW format. Free.
Climate.OneBuilding Global Typical-year hourly data from various sources. Over 3,000 locations. SAM-ready EPW format. Free.
SIREN Toolkit Global Single-year (1979 - present) from NASA MERRA-2. Use makeweather2 program in toolkit or download separate sen_makeweather_getmerra2 package. Free.

The following sources are are for commercial data products that will work with SAM:

Source Region Description
Clean Power Research North America Single-year data (1998 - ). Satellite-derived data. 10 km grid cells. SAM-ready TMY3 format. $$ (some free data).
SolarGIS Global Single-year and typical-year data (1994 - ). Satellite-derived data. 250 m grid cells. $$.
Meteonorm Global Single-year and typical-year data. Model-generated data from various sources. Various formats. $$.
White Box Technologies Global Single-year and typical-year data. Over 4,000 locations. Data from ASHRAE IWEC2, NSRDB, CWEC2, and CZ2010. $$.
Deutscher Wetterdienst WebWerdis Germany and other countries Single-year data. Free and $$.


Weather File Formats

SAM weather files are text files. SAM can read weather files in several formats.

The native SAM formats are SAM CSV for solar resource data and SRW for wind resource data:

  • SAM CSV is for solar resource data. It is a comma-delimited (.csv) format (format description  PDF 170 KB, example file CSV 405 KB).
  • SRW is a comma-delimited (.srw) format and for wind resource data. For a description, see SAM's Help system. See the wind_resource folder in your SAM installation for examples of the file.

SAM's solar models can also read weather files in the following formats:

  • EPW, comma-delimited (.epw) format developed by the U.S. DOE for the  EnergyPlus Energy Simulation Software, and described  here.
  • NSRDB 1991-2010 update collection, and described in the update's user manual ( PDF 18 MB).

  • TMY3, a comma-delimited (.csv) format developed by NREL for the National Solar Radiation Database (NSRDB) 
  • TMY2, non-delimited (.tm2) format developed by NREL for the  NSRDB 1961 - 1990 collection, and described  here.

Dealing with Uncertainty

The weather file you choose for an analysis in SAM is your assumption of the renewable resource available at the system's location. You also make assumptions about the physical characteristics of its design, project financial structure, and installation and operating costs. Each assumption has a degree of uncertainty that contributes to the uncertainty of the results of your analysis.

When you use SAM to predict the electrical output of a renewable energy system, uncertainty in the weather data is one of the main sources of uncertainty in your SAM results. When you run SAM with one of the NSRDB weather files or weather files from one of the other sources mentioned here, you are trying to predict the future using historical data. That's inherently uncertain, so you should be prepared to present SAM results as ranges of probable values rather than as a specific values.

Here are some general tips to help you do so:

  • Read the documentation that accompanies the weather data you are using. The documentation should describe the source of the data, method used to develop the files, and provide information about data quality and uncertainty. The list of data sources below includes links to the data's documentation.
  • If you have access to weather files for several locations near the system site, run the model for the different locations. The results can help give you some insight into the degree variation in the weather impacts the results of your analysis. This approach can also give you a sense of how the geography around the site affects the resource.
  • Present the results of your simulations as ranges of values, not as absolute values. People intepreting the results of your analysis should understand that the model's predictions are statistically uncertain. See the weather data example below.

For a good discussion of weather files and uncertainty in energy modeling, see Stoffel et. al. 2012 ( PDF 7.5 MB). Although this handbook was written for an audience of concentrating solar power analysts, the information is also useful for anyone using SAM to model photovoltaic systems, and to some degree, wind systems.

Typical-year Data

When you model a renewable energy system in SAM, it is usually for a renewable energy system that will generate electricity over a period of many years. You may be using SAM to estimate how much electricity a parabolic trough system will generate hourly, monthly, and annually, on average, over a 30-year period. Or, you may be trying to determine what electricity power price a wind farm or utility-scale PV project needs to meet a desired internal rate of return over a 25-year project life. Or, you could be trying to estimate how much a customer will save on her monthly electric bill over the next ten years if you install a roof-top PV system on her home. To save simulation time and complexity, SAM only simulates the system's performance over a single year. So, for these kinds of analyses, you need to use a weather file that represents the resource over many years.

TMY is an acronym for typical meteorological year. A typical-year file contains one year of hourly data that represents historical weather data over a multi-year period. It is typical because it uses one year's worth of typical data to represent the original data over the entire period. There are different methods for determining the typical values (see below for details). You can think of typical-year data as the average of the original data over the historical period, but it is more accurate to say that the data is typical because the methods involve more than just calculating average values. A TMY file is meteorological because the method for developing the files involves analysis of solar resource data and weather data (wind speed, ambient temperature, etc.). Some data sources provide different kinds of typical-year data files, such as typical GHI year (TGY) and typical DNI year (TDY) files, which were developed by analyzing the solar resource data but not the weather data -- these are also typical-year data files, but use a different definition of "typical".

The term "TMY" can be confusing because sometimes people use it incorrectly to describe a file format or data source. Here are some examples of how to describe weather files to make the distinction clear:

  • SAM's weather file collection contains a file named  AZ Phoenix Sky Harbor Intl Ap (TMY3).csv. The file contains typical-year data, and is in the SAM CSV format. Its data source is the NREL NSRDB 1991 - 2010 update.
  • The file  Denver CO_1998.tm2 was generated by an old version of SAM. It contains single-year data for 1998 (not typical-year data), is in the TMY2 format, and its data source is the old NREL Solar Prospector website.

A typical year file uses a single year of hourly data to represent the renewable resource and weather conditions over a multi-year period. The typical year methodology involves analyzing a multi-year data set and choosing a set of 12 months from the multi-year period that best represent typical conditions over the long term period. For example, a typical year file developed from a set of data for the years 1998-2005, might use data from 2000 for January, 2003 for February, 1999 for March etc. Annual simulation results from typical year weather data are suitable for long-term economic analysis.

Single-year Data

Single year data represents the weather at a location for a specific year. Single year data is appropriate for analysis of a system's performance in a particular year when you are not using the results to predict economic value over many years. Single-year data may also be appropriate for analyses involving time-dependent electricity pricing or electric loads for a given year.

You can also use a set of single-year weather files for many years to calculate a system's hourly output over a long term period. This is the approach SAM uses for P50/P90 analysis.

P50/P90 Analysis

A P50/P90, or probability exceedance analysis, involves running a set of single-year simulations to calculate annual output values, and then from those values determining the annual output value that was exceeded 50% of the time (the P50 value) and the value that was exceeded 90% of the time (P90 value). A P50/P90 analysis in SAM requires single-year data for at least 15 years, but ideally more. For example, a P50 value of 30 MWh would mean that based on the historical data, there is a 50% likelihood that the system's annual output will exceed 30 MWh. Similarly, a P90 value of 30 MWh, would mean that there is a 90% likelihood that the output will exceed 30 MWh.

SAM's P50/P90 feature requires a set of single-year weather files that you put in a folder on your computer. You can download NSRDB Historical Single Year Data for the 237 locations in the TMY2 data collection.

For a description of SAM's P50/P90 methodology, see Dobos et. al. 2012 ( PDF 423 KB).

Weather Data Example

Related FAQs:
TMY3 Proximity Site

For a system with an address in Golden, Colorado on the NREL campus, you could establish a range of reasonable values for its annual output using three typical-year data files: 1) Boulder, the nearest location in the NSRDB 1961 - 1991 collection (TMY2), 2) Denver/Centenial Boulder, the nearest location in the NSRDB 1991 - 2010 update (TMY3), and 3) the Solar Prospector data for the 10 km square that contains the address. The map in Figure 1 shows the system location and the three data sites. The Boulder TMY2 site is about 30 km (19 miles) north of the system location. The TMY3 site is within a few kilometers of the system location, and the system location is inside the borders of the Solar Prospector 10 km square. (The 10 km square is approximate, and looks like a rectangle because of the map projection.) Table 1 shows the annual output that SAM estimates for a 4 kW system for each dataset (using PVWatts to model a fixed array tilted at latitude with a 0.77 DC-to-AC derate factor). These values provide a basis for estimating a reasonable range of annual output values for the system. For this example, you could say that based on historical weather data and the system's physical description and model assumptions, it would be reasonable to expect the system's output to be between 5.5 MWh/year and 5.9 MWh/year.

Map showing three weather files for locations near a project site on the NREL campus.

Figure 1. Map showing three solar resource data sites available for a system location on the NREL campus in Golden, Colorado

Table 1. PVWatts results for a 4 kW photovoltaic system at an address on the NREL campus using the three solar resource data choices available for that location
Weather File Annual Ouput (kWh)
Boulder, CO TMY2 5,835
Denver/Centennial TMY3 5,508
Solar Prospector 5,889

Ground-measured data is data taken from devices that measure solar radiation, temperature, wind speed, humidity, and atmospheric pressure. These devices take measurements at a specific location and store data at some time resolution, typically every minute, ten minutes, or fifteen minutes. Preparing this data for use in a weather data file involves collecting the data, checking it for data quality issues, filling data gaps, and calculating hourly values from the higher temporal resolution data. Ground measured data provides accurate historical information, but is limited to the location of the measurement devices.

Satellite-derived data is data generated by a computer model that processes data from digital images of the earth's surface taken from a satellite. Satellite-derived data can provide historical information about large geographic areas.

Creating your Own Weather File

SAM's SAM CSV (solar) and SRW (wind) weather file formats are basic comma-separated formats that make it relatively easy to create weather files with your own data. SAM's Weather File Checker macro helps you identify formatting problems with files in the SAM CSV format. The Weather File Converter macro converts files in the TMY3, TMY2, and EPW formats into the SAM CSV format.In some cases, you may have weather data from a resource measurement program, meteorological stations, or some other source. SAM can read a weather file with data from any source, as long as it is in one of the formats described here without any formatting errors, gaps in the data, or invalid values. You can create the file in a spreadsheet or database program, or write your own software to create the file.


Dobos, A.; Gilman, P.; Kasberg, M. (2012). "P50/P90 Analysis for Solar Energy Systems Using the System Advisor Model." NREL Conference Paper Preprint No. CP-6A20-54488. ( PDF 432 KB)

Habte, A.; Lopez, A.; Sengupta, M.; Wilcox, S. (2014). "Temporal and Spatial Comparison of Gridded TMY, TDY, and TGY Data Sets." NREL Report No. TP-5D00-60866. ( PDF 17.4 MB)

National Solar Radiation Database. (1992). " National Solar Radiation Data Base User's Manual (1961-1990)." [TMY2 format description.]

Sengupta, M.; Habte, A.; Kurtz, S.; Dobos, A.; Wilbert, S.; Lorenz, E.; Stoffel, T.; Renne, D.; Myers, D.; Wilcox, S.; Blanc, P.; Perez, R. (2015). "Best Practices Handbook for the Collection and Use of Solar Resource Data for Solar Energy Applications." NREL Report No. TP-5D00-63112. ( PDF 8.9 MB)

Wilcox, S.; Marion, W. (2008). "Users Manual for TMY3 Data Sets (Revised)." 58 pp.; NREL Report No. TP-581-43156. ( PDF 1.7 MB)

Theme by Danetsoft and Danang Probo Sayekti inspired by Maksimer