Skip to content

Release Guide

Naming Conventions

Major Releases

POWER will bundle individual microservice versions to make a major release of the POWER Services. The POWER Service releases will have the same numbering convention and reporting requirements as the services, but within the POWER Services release the service version will be noted.

Note

Production applications will be updated outside of the major POWER Services releases, but these will not break existing functionality (confirmed by unit and integration testing).

Conventions

Each individual service will have an independent version number that is tied to a specific promotion. All promotions to the production environment, regardless of how minor, will trigger a new version number. All promotions, version changes, require a statement of changes to be logged in reference to the version number. If a major release (Position 1) is triggered all the services will be frozen and a new version number change will be implemented.

Reporting

Each version number will contain a minimum amount of information like:

  1. An overview of the change(s) made.
  2. The purpose of the change(s) in relation to the service itself and POWER Services.
  3. Impact of the change(s) to the community and other services.

Numbering

[name-of-service] v01.02.03 or [name-of-service] v1.2.3

  • Position 1: Major upgrades to the services and/or system (e.g. moving a flask application from a cgi-bin).
  • Position 2: Significant updates to Functionality and/or additions (e.g. adding/removing a new endpoint, an option, and/or temporal level).
  • Position 3: Any change to the code that is pushed to production.

The leading zeros can be omitted when writing the release version.

Release Notes

Data Version 901

Traceability & Changes in Values

The Services Version 2 of POWER provides Data Version 901 POWER data (Services Version 1 provided Data Version 801). The Data Version 901 improves the 1) underling source data models and 2) enhances traceability to source data models. Specifically, the underling source data models for radiation-based parameters has changed from SRB v3 to SRB v4 for 1984 through 2000. From 2001, we now provide CERES SYN1deg until three months before present time. Like in previous versions, POWER continues to provide support for Near Real Time (NRT) availability with FLASHFlux. For the enhanced traceability, Data Version 901 POWER data includes improved parameter abbreviations and definitions, in order to be more clear about what parameter is being used. The most prominent change is that POWER provides data at the underlying source data model's grid resolution.

So, changes in the values are to be expected:

  • For meteorology-based parameters, we are no-longer using bilinear interpolation to put the source data on a common 0.5 x 0.5 degree grid as it was in Data Version 801 (to enhance traceability). Not using interpolation causes some slight variation in the values compared to the previous version, but the values are exactly the same as the source dataset for a particular point location. The differences in values between Data Version 801 and 901 could be more pronounced for a specific point location if:

  • the location is close to a land/sea boundary.

  • the location is close to the grid box boundary (since the data could potentially have pulled from a adjacent grid box when it was not using original source data grid).

  • For solar-based parameters, we are no-longer replicating the source data on a common 0.5 x 0.5 degree grid; we changed the underling source data models to newer versions. For more information, please review the data sources here.

  • The elevation, or altitude, is also not interpolated so the same reasons for meteorology-based parameters apply.

New Parameters Names

Some of the parameter names in your example changed; the definition just to confirm:

  • ALLSKY_TOA_SW_DWN to TOA_SW_DWN: Top-Of-Atmosphere Shortwave Downward Irradiance - The total solar irradiance incident (direct plus diffuse) on a horizontal plane at the top of the atmosphere (extraterrestrial radiation).

  • DNR to ALLSKY_SFC_SW_DNI: The direct solar irradiance incident to a horizontal plane normal (perpendicular) to the direction of the sun's position under all sky conditions.

  • SRF_ALB to ALLSKY_SRF_ALB: The direct solar irradiance incident to a horizontal plane normal (perpendicular) to the direction of the sun's position under all sky conditions.

  • DIFF to ALLSKY_SFC_SW_DIFF: The diffuse (light energy scattered out of the direction of the sun) solar irradiance incident on a horizontal plane at the surface of the earth under all sky conditions.

  • PRECTOT to PRECTOTCORR: Precipitation Corrected - The bias corrected average of total precipitation at the surface of the earth in water mass (includes water content in snow). In V1 you where getting PRECTOTCORR when you request PRECTOT.

  • In the previous API version, that change happened dynamically but, in this version, we are working to enhance traceability between the underlying source data models (to be clear what parameter is being used).

  • KT to ALLSKY_KT: All Sky Insolation Clearness Index - A fraction representing clearness of the atmosphere and the all sky insolation that is transmitted through the atmosphere to strike the surface of the earth divided by the average of top of the atmosphere total solar irradiance incident.

  • SG_HR_AZM_ANG_AVG to SG_SAA_HR: Average Solar Azimuth Angle for Climatological Month - The angle of the vector from the earth point to the suns position at GMT Times.

  • SG_HR_HRZ_ANG_AVG to SG_HRZ_HR: Average Hourly Solar Angles Relative To The Horizon for Climatological Month - The vertical angle of the sun above the horizon at GMT Times. The determination of monthly averaged maximum solar angle relative to the horizon for each month is based on the monthly average day.

Change in Minimum Insolution Over Consecutive p-day Period Parameter

There was a change in the consecutive p-day period parameters; we now provide the insolation value not a percentage. The value is the cumulative minimum amount of insolation over the p-days period.

Since we now provide the insolation value, the percentage can be calculated following the example below:

INSOL_CONSEC_07_MIN / INSOL_CONSEC_07 = %

Services Version 2

Current

Version Date Category Changes
v2.0.0 August 2021 WEB Updated documentation, parameter dictionary, and general website content.
v2.0.1 August 2021 DAV Bug fixes for parameter groupings.
v2.2.1 August 2021 API Enabled single point hourly data access and added baseline services for POWER 901 Data.

Historical

Version Date Category Changes
v2.0.0 August 2021 WEB Added POWER Dashboards that include Temporal Availability and Metrics Overview pages.
Added OpenAPI Specification API landing pages
Updated documentation, parameter dictionary, and general website content landing pages.
v2.0.0 August 2021 DAV Added a new widgets for the report API services and integrated hourly data access.
v2.2.0 August 2021 API Enabled single point hourly data access and added baseline services for POWER 901 Data.
v1.1.4 May 2020 WEB General website content updates.
Added the web-based POWER Docs.
v1.1.4 May 2020 DAV Updates to documentation branding, and resource links.
v1.1.4 May 2020 API Re-implemented equatorial solar irradiance tilt parameters.
v1.1.3 November 2019 WEB General website content updates.
v1.1.3 November 2019 DAV Added back the Basemap Gallery.
v1.1.3 November 2019 API Fixed a solar irradiance parameters bug.
v1.1.2 May 2019 WEB General website content updates.
v1.1.2 May 2019 DAV Added 2018 option to start and end dates for monthly and annual data.
v1.1.2 May 2019 API Added support for 2018 for monthly and annual data.
Fixed solar irradiance parameters bug.
Fixed filenames latitude and longitude rounding bug.
Fixed solar geometry Cosine Solar Zenith Angle parameter bug.
v1.1.1 February 2019 WEB Updated FAQ documentation.
Resolved CSS issues on mobile platforms.
v1.1.1 February 2019 DAV Added 2019 option to start and end dates.
Updated DAV widget error handling messages.
v1.1.0 December 2018 WEB Added additional parameters to Parameter Dictionary.
Updated Methodology to version 9.
v1.1.0 December 2018 DAV Added minimum and maximum Solar Irradiance for Equator Facing Tilted Surfaces within the Single Point widget.
v1.1.0 December 2018 API Fixed Daily ASCII header bugs.
Added data entry and error handling checks for API.
Added minimum and maximum Equator Facing Tilted Surfaces to the API.
v1.0.9 August 2018 WEB Added SSE Announcement Decommission Letter.
Added documentation for how to access data and how to find parameters.
v1.0.9 August 2018 DAV Added additional solar and meteorological parameters.
v1.0.9 August 2018 API Fixed the Solar Geometry JSON output bug.
Fixed T2M_RANGE units conversion bug.
Added Solar Irradiance maximum and minimum parameters.
v1.0.8 May 2018 WEB Added additional parameters to Parameter Dictionary.
Updated documentation to reflect v1.0.8 of the API.
v1.0.8 May 2018 DAV Updated parameters groups for the widgets; similar to the previous POWER websites and apps.
Added Thermal Zones and Thermal Moisture Zones to the Layer List widget.
v1.0.8 May 2018 API Added additional POWER Project header and parameter information in the CSV output type.
Added additional solar geometry and tilt parameters
v1.0.7-beta February 2018 WEB Added additional parameters to Parameter Dictionary.
Updated documentation to reflect v1.0.7beta of the API.
v1.0.7-beta February 2018 DAV Added Layer List Widget to visualize global climatological parameters on a web map.
v1.0.7-beta February 2018 API Added additional POWER Project header and parameter information in the JSON output type.