Skip to content

Release Guide

Naming Conventions

Major Releases

The POWER project bundles individual microservice versions to make a major releases of the POWER Services. All POWER services and resources will be following the Semantic Versioning Specification (SemVer) and have the reporting requirements. This will include the date of change, version number, a title, and a detailed description.

Note

  • The version numbers for all services are tracked independently.
  • Any breaking change will be communicated to users via the following:
    • Direct outreach from POWER's user list.
    • Banner notifications on the POWER websites.
    • The future changes section on this webpage.

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:

  1. Date of change
  2. TVersion Number
  3. Title
  4. Detailed Description
  5. 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. a breaking change).
  • 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.
  • The application version is included in the response headers as x-app-version.

Version History

Websites

The changelog for the Websites that provide context about POWER's data and services.

Please select a service name above to explore the version history of POWER's websites.

Website Date Version Title Description
Homepage 4/06/2022 v2.2.5 Branding Update Corrected the POWER logo.
DAV 4/13/2022 v2.3.9 Enabled 2021 Data Enabled 2021 data for access by the widgets.
Docs 4/06/2022 v2.2.11 Content Update Added more versioning tracking information.
Dashboards 4/06/2022 v2.2.10 Branding Update Corrected the POWER logo.
API Pages 4/06/2022 v2.0.3 Branding Update Corrected the POWER logo.
Date Version Title Description
4/06/2022 v2.2.5 Branding Update Corrected the POWER logo.
3/15/2022 v2.2.4 Updated Sitemap Updated the sitemap.
2/22/2022 v2.2.3 Branding and Content Updates Updated to the new POWER logo and icon and removed legacy content.
10/12/2021 v2.2.2 Content Update Corrected the logo's resource path.
8/9/2021 v2.2.1 Updated Site Structure Updated the path for the sitemap and updated robots.
8/5/2021 v2.2.0 Removed the Beta References Removed the beta references from the content and resource paths.
7/19/2021 v2.1.3 Reorganized Website Content Moved the team page to documentation and corrected resource paths.
7/6/2021 v2.1.1 Corrected Spelling Mistakes Corrected spelling mistakes in website content.
5/11/2021 v2.1.0 Reorganized Content Websites Moved publications and release notes to the documentation pages.
4/27/2021 v2.0.2 Added Earthdata User Forum Added the Earthdata User Forum link to the homepage.
¾/2021 v2.0.1 Changed Documentation References Changed the references to documentation content and updated data sources.
1/20/2021 v2.0.0 Documentation Starting Point This is the starting point for the homepage website.
Date Version Title Description
4/13/2022 v2.3.9 Enabled 2021 Data Enabled 2021 data for access by the widgets.
4/06/2022 v2.3.8 Branding Update Corrected the POWER logo.
2/22/2022 v2.3.7 Branding and Text Updates Updated to the new POWER logo and icon and text updates to landing pages.
1/25/2022 v2.3.6 Updated Climatology Range Updated default climatology range improve usability.
11/2/2021 v2.3.5 Widget Return Panel Update Widget return panel text update to improve usability.
10/21/2021 v2.3.4 Regional Area Bugfix Updated the regional area section tool to have integrated checks on the area selected.
10/4/2021 v2.3.3 Global Parameter Bugfix Fixed the parameter drop-down for global spatial option.
9/16/2021 v2.3.2 Regional Time Range Bugfix Added Regional Day Limit and Fixed Time Ranges.
8/25/2021 v2.3.1 Date Range Update Update the date range for the reports.
8/6/2021 v2.3.0 Added Regional Added regional widget and removed beta references.
3/11/2021 v2.2.0 Custom Climatology Update Updated the custom climatology groups.
⅕/2021 v2.1.0 Hourly Data Access Available Have the hourly widget working with the EPW format.
10/27/2020 v2.0.0 Renamed a Widget Updated widget name from 'Interannual' to 'Monthly & Annual'.
5/1/2020 v1.1.4 Documentation Branding Updates Updates to documentation branding, and resource links.
11/1/2019 v1.1.3 Basemap Gallery Enabled the Basemap Gallery to help users visualize locations.
2/1/2019 v1.1.1 Updated Times Available Updated the start and end dates for support Near Real Time (NRT) data access.
2/1/2019 v1.1.1 Error Handling Messages Updated the widgets error handling messages.
12/1/2018 v1.1.0 Equator Facing Tilted Surfaces Added minimum and maximum Solar Irradiance for Equator Facing Tilted Surfaces within the Single Point widget.
8/1/2018 v1.0.10 Additional Data Parameters Added additional solar and meteorological data parameters to groups.
5/1/2018 v1.0.8 Updated Parameters Groups Updated parameters groups for the widgets; similar to the previous POWER websites and apps.
5/1/2018 v1.0.9 Thermal Zones Visualization Added Thermal Zones and Thermal Moisture Zones to the Layer List widget.
2/1/2018 v1.0.7 Global Climatology Visualization Added Layer List Widget to visualize global climatological parameters on a web map.
Date Version Title Description
4/06/2022 v2.2.11 Content Update Added more versioning tracking information.
3/15/2022 v2.2.10 Content Update Added more versioning tracking information.
2/22/2022 v2.2.9 POWER Branding and Text Updates Updated to the new POWER logo and icon and text updates.
2/4/2022 v2.2.8 Content Update Added more versioning tracking information.
1/28/2022 v2.2.7 Content Update Added more versioning tracking information.
1/25/2022 v2.2.6 Content Update Updated some notes to improve usability, added more versioning tracking information, and updated the publications.
12/6/2021 v2.2.5 Semantic Versioning Tracking Added the semantic versioning tracking and more publications.
11/17/2021 v2.2.4 Announcement & Validation Updates Updates for UN COP 26 and solar data validation updates.
10/4/2021 v2.2.3 Updated Services Section Updated the services section content for OPeNDAP changes.
9/16/2021 v2.2.2 Documentation Enhancements Added usability notes and updates to content.
8/24/2021 v2.2.1 Documentation Readability Updates Documentation updates to enhance readability of methodology.
8/9/2021 v2.2.0 Reorganized Website Content Moved team members to the documentation pages and corrected resource paths.
7/12/2021 v2.1.2 Enhanced Publications Tracking Added enhanced publications, conferences, and references tracking.
6/14/2021 v2.1.1 Updated Validation Documentation Updates to the validation documentation in the data methodology.
5/11/2021 v2.1.0 Reorganized Content Websites Moved publications and release notes to the documentation pages.
¾/2021 v2.0.2 Updated Validation Documentation Updates to the validation documentation in the data methodology.
2/23/2021 v2.0.1 Updated Documentation Theme Updated the documentation theme to a new version.
1/21/2021 v2.0.0 Documentation Starting Point This is the starting point for the documentation.
Date Version Title Description
4/06/2022 v2.1.3 Branding Update Corrected the POWER logo.
2/22/2022 v2.1.2 Branding Update Updated to the new POWER logo and icon.
8/5/2021 v2.1.1 Removed the Beta References Removed the beta references from the content and resource paths.
7/16/2021 v2.1.0 NRT Hourly Dashboard Updated the Dashboards for NRT Hourly.
12/15/2020 v2.0.0 Beta Configurations Implemented Updated the path structure to support the public Beta and system enhancements.
Date Version Title Description
4/06/2022 v2.0.3 Branding Update Corrected the POWER logo.
2/22/2022 v2.0.2 Branding Update Updated to the new POWER logo and icon.
8/5/2021 v2.0.1 Removed the Beta References Removed the beta references from the content and resource paths.
12/24/2020 v2.0.0 Beta Configurations Implemented Updated the path structure to support the public Beta and system enhancements.

Datastore

The changelog for the Datastore that supplies data to the APIs.

Please select the detailed changes tab to explore the version history of POWER's Datastore.

Date Version Title Description
4/13/2022 v9.6.8 2021 Monthly and Annual Data Enabled access to 2021 monthly and annual data.
Date Version Title Description
4/13/2022 v9.6.8 2021 Monthly and Annual Data Enabled access to 2021 monthly and annual data.
4/12/2022 v9.6.7 Blocked Access to Parameters Blocked access to parameters with issues from consecutive days bug.
1/25/2022 v9.6.6 Blocked Access to Parameters Blocked access to parameters with issues from solar zenith angle and irradiance bug.
12/23/2021 v9.6.5 Re-enabled MERRA-2 Processing Re-enabled the MERRA-2 data that have been corrected; replacing the GOS5.12.4 placeholder data.
12/21/2021 v9.6.4 Unit Correction for Snow Depth Corrected the units of the Snow Depth data parameter from centimeters to meters in the data archive.
11/30/2021 v9.6.3 Removed Incorrect Data Removed MERRA-2 data with errors and replacing it with GOS5.12.4 until the source data fix is available.
11/18/2021 v9.6.2 Added IMERG Precipitation Added Near Real Time (NRT) IMERG precipitation data to daily UTC.
10/15/2021 v9.6.1 Updated Thermal Zones After precipitation correction re-computed the Thermal Zones and Thermal Moisture Zones.
10/1/2021 v9.6.0 Precipitation Correction Reprocess MERRA-2 precipitation for all temporal levels due to a significant digits issue.
8/31/2021 v9.5.1 Reprocessed FLASHFlux Data Reprocessed FLASHFlux Data between 7/28/2021 and 7/30/2021 due to anomalies in source data.
8/16/2021 v9.5.0 Corrected Data Inversion Issue Corrected the data issue that caused data after 2020 to be inverted.
7/15/2021 v9.4.0 Hourly Meteorology Now NRT Made the hourly meteorology data dynamically update 2 days behind Near Real Time (NRT).
7/7/2021 v9.3.0 Fully Enabled NRT Data Fully enabled the Near Real Time (NRT) processing for daily endpoints.
7/2/2021 v9.2.1 Block Simultaneous Executions Added a executer to block simultaneous executions.
7/2/2021 v9.2.0 New FLASHFlux Version Reprocessed FLASHFlux from 2021-06-01 with new data version (401401).
6/24/2021 v9.1.2 NRT Appending Speed Increase Bug fixes and speed increases to Near Real Time (NRT) appending tool.
6/23/2021 v9.1.1 Hourly Dynamically Updates Made the hourly meteorology and solar data dynamically update 3 months behind Near Real Time (NRT).
6/16/2021 v9.1.0 ARD Fully Processed Processed and stored the initial version of Analysis Ready Datasets (ARD) for use in services.
3/31/2021 v9.0.2 Solar Correction Re-processed the CERES with a correction to the solar irradiance values and included more data parameters.
2/16/2021 v9.0.1 Updated Parameters Metadata Updated the datastore's parameters metadata, like unit names, to support on the fly conversions.
1/1/2021 v9.0.0 Enhanced Traceability & Compression Enhanced traceability using source data grids and using advanced compression.

Data Version v9.x.x

  1. Underling source data is updated.
  2. Enhanced traceability to source data.
    • Improved parameter abbreviations and definitions.
    • Using underlying source data's grid resolution.
  3. Hourly data availability and new hourly-based data formats.

Data Version v8.x.x

The POWER Project's data version v8.x.x was on a common 0.5 x 0.5 degree grid. In future versions, we are no-longer using bilinear interpolation on meteorology-based parameters and not using replication on solar-based parameters to store a version on a common 0.5 x 0.5 degree grid.

System APIs

The APIs that supply consistent configuration information across the APIs. System API Services

Please select a service name above to explore the version history of POWER's services.

Service Date Version Title Description
Manager 4/13/2022 v2.2.18 Updated Response Headers Code updates for enhanced response headers.
Resources 4/13/2022 v2.2.16 Updated Response Headers Code updates for enhanced response headers.
Date Version Title Description
4/13/2022 v2.2.18 Updated Response Headers Code updates for enhanced response headers.
4/06/2022 v2.2.17 Code Enhancements Added code enhancements to support efficient hosting of services.
3/15/2022 v2.2.16 Code Enhancements Added code enhancements to support efficient hosting of services.
2/22/2022 v2.2.15 Textual Updates Textual updates to data format headers and a parameter alternate name.
2/4/2022 v2.2.14 Fixed Parameter Groups Blocked the normalized insolation clearness indexes data parameters within Data Access Viewer (DAV) groups and fixed a spelling mistake in the parameter definitions.
1/28/2022 v2.2.13 Unblocked Data Parameter Unblocked the insolation clearness indexes data parameters.
1/25/2022 v2.2.12 System Enhancements and Bugfixes Changed the package managers from conda to mamba, corrected internal reference paths to resources, updated the services Cross-Origin Resource Sharing (CORS) settings, and blocked parameters with issues from irradiance bug.
12/6/2021 v2.2.11 Updated Parameters Groupings Updated the parameters groupings to include precipitation sum and wind direction.
11/17/2021 v2.2.10 Updates for Future Parameters Updated some data field names for future data parameters.
11/3/2021 v2.2.9 Updates for Future Parameters Updated some data field names for future data parameters.
10/19/2021 v2.2.8 Compression for Responses Implemented Brotli & Gzip compression for response objects and server settings updates to improve performance.
10/13/2021 v2.2.7 Updates for Future Parameters Added future parameters and updated groupings for the Data Access Viewer Enhanced (DAVe).
10/2/2021 v2.2.6 Updated Global Groupings Updated the parameters in the global groupings.
9/22/2021 v2.2.5 Response Headers: App Version Added the application version to the response headers.
9/22/2021 v2.2.4 Response Headers: Timestamps Corrected the rounding for data parameters and updated the response headers to include timestamps for logging.
9/16/2021 v2.2.3 Updated Parameter Definitions Updates to the parameter definitions.
8/18/2021 v2.2.2 Updated Parameter Definitions Updates to the parameter definitions.
8/9/2021 v2.2.1 Improved Response Structure Improved the responses timeout, response header attributes, and other user reported bug fixes.
7/9/2021 v2.2.0 Production Starting Point Starting point for the public production release including, updates from the beta period, and an updated backend datastore.
Date Version Title Description
4/13/2022 v2.2.16 Updated Response Headers Code updates for enhanced response headers.
4/06/2022 v2.2.15 Metrics Update: March 2022 The curated metrics update for March (2022/03) and code enhancements.
3/15/2022 v2.2.14 Metrics Update: February 2022 The curated metrics update for February (2022/02) and code enhancements.
2/22/2022 v2.2.13 Textual Updates Textual updates to data format headers and a parameter alternate name.
2/4/2022 v2.2.12 Metrics Update: January 2021 The curated metrics update for January (2022/01) and data parameters count update.
1/25/2022 v2.2.11 Metrics Update: December 2021 The curated metrics update for December (2021/12), updated the metrics to differentiate CERES to FLASHFLUX in the reports, changed the package managers from conda to mamba, corrected internal reference paths to resources, and updated the services Cross-Origin Resource Sharing (CORS) settings.
12/6/2021 v2.2.10 Metrics Update: November 2021 The curated metrics update for November (2021/11).
11/1/2021 v2.2.9 Metrics Update: October 2021 The curated metrics update for October (2021/10).
10/19/2021 v2.2.8 Added Middleware Added lower case middleware.
10/14/2021 v2.2.7 UN COP 26 Updates ArcGIS Story Map content updates to support UN COP 26.
10/1/2021 v2.2.6 Metrics Update: September 2021 The curated metrics update for September 2021 (2021/09).
9/28/2021 v2.2.5 Metrics Update: August 2021 The curated metrics update for August 2021 (2021/08).
9/22/2021 v2.2.4 Response Headers: App Version Added the application version to the response headers.
9/21/2021 v2.2.3 Response Headers: Timestamps Corrected the rounding for data parameters and updated the response headers to include timestamps for logging.
8/9/2021 v2.2.2 Improved Response Structure Improved the responses timeout, response header attributes, and other user reported bug fixes.
7/16/2021 v2.2.1 Metrics Updates Updated the metrics dashboards to visualize for Near Real Time (NRT) hourly meteorology data.
7/12/2021 v2.2.0 Production Starting Point Starting point for the public production release including, updates from the beta period, and an updated backend datastore.

Temporal APIs

The APIs that return user community specific Analysis Ready Data (ARD) products. See more at Temporal API Services

Please select a service name above to explore the version history of POWER's services.

Service Date Version Title Description
Hourly 4/13/2022 v2.2.24 Updated Response Headers Code updates for enhanced response headers.
Daily 4/13/2022 v2.2.23 Updated Response Headers Code updates for enhanced response headers.
Monthly 4/13/2022 v2.2.19 Enabled 2021 Data Enabled 2021 data and code enhancements to enhance response headers.
Climatology 4/13/2022 v2.2.20 Enabled 2021 Data Enabled 2021 data and code enhancements to enhance response headers.
Date Version Title Description
4/13/2022 v2.2.24 Updated Response Headers Code updates for enhanced response headers.
4/06/2022 v2.2.23 Updated Data Formats Updated the SAM and SRW formats based on feedback from NREL.
3/16/2022 v2.2.22 API Landing Page Fix Updated the OpenAPI Specification JSON to fix the API Landing Page.
3/15/2022 v2.2.21 New and Updated Data Formats Updated the EPW to use Local Time (LT) and added the SAM CSV format for solar and the SRW format for wind for use in the NREL SAM Software.
2/22/2022 v2.2.20 Textual Updates Textual updates to data format headers and a parameter alternate name.
2/4/2022 v2.2.19 Spelling Update Fixed a spelling mistake in the parameter definitions.
1/28/2022 v2.2.18 Unblocked Data Parameter Unblocked the insolation clearness indexes data parameters.
1/25/2022 v2.2.17 System Enhancements and Bugfixes Changed the package managers from conda to mamba, corrected internal reference paths to resources, updated the services Cross-Origin Resource Sharing (CORS) settings, fixed spelling mistake in OpenAPI Uniform Resource Identifier (URI) descriptions, updated the hour index for EPW formats, and added an override Solar Zenith Angle (SZA) nighttime values, 90 degrees, to null.
12/6/2021 v2.2.16 Corrected Parameters Bugs Corrected a bug with the display of the cloud optical depth parameters.
11/17/2021 v2.2.15 Updated Parameters Information Updated the parameters to include units and availability information.
11/3/2021 v2.2.14 Updates for Future Parameters Updated some data field names for future data parameters.
10/19/2021 v2.2.13 Compression for Responses Implemented Brotli & Gzip compression for response objects and server settings updates to improve performance.
10/12/2021 v2.2.12 Response Format Fixes Implemented JSON and Xarray format fixes.
10/1/2021 v2.2.11 LST Conversation Update Corrected an hour offset issue with the Local Solar Time (LST) time standard.
9/29/2021 v2.2.10 Dynamic Date Re-Rendering Added support for YYYY dates to be converted to YYYYMMDD allowing easier transition between API temporal levels.
9/28/2021 v2.2.9 Core System Enhancements Enhancements to resources allocation, service scaling, and improved input/output performance.
9/22/2021 v2.2.8 Response Headers: App Version Added the application version to the response headers.
9/22/2021 v2.2.7 Response Headers: Timestamps Corrected the rounding for data parameters and updated the response headers to include timestamps for logging.
9/20/2021 v2.2.6 Precipitation Data Available After corrections to the underling datastore re-enabled precipitation.
9/16/2021 v2.2.5 Parameters Data Override Added a setting to override a parameter values forcing a missing data response for all data values.
8/31/2021 v2.2.4 Direct S3 Data Access Enabled direct S3 data access for source datastore settings.
8/24/2021 v2.2.3 Parameters Values Override Added a setting to override a parameter values forcing a missing data response for specific data values.
8/9/2021 v2.2.2 Improved Response Structure Improved the responses timeout, response header attributes, and other user reported bug fixes.
7/15/2021 v2.2.1 NRT Hourly Meteorology Removed the truncation to enable Near Real Time (NRT) hourly meteorology data.
7/9/2021 v2.2.0 Production Starting Point Starting point for the public production release including, updates from the beta period, and an updated backend datastore.
Date Version Title Description
4/13/2022 v2.2.23 Updated Response Headers Code updates for enhanced response headers.
4/06/2022 v2.2.22 Code Enhancements Code enhancements to support future migrations.
3/15/2022 v2.2.21 API Landing Page Fix Updated the OpenAPI Specification JSON to fix the API Landing Page.
3/15/2022 v2.2.20 Data Fix and Code Enhancements Added a value override for irradiance components and code enhancements.
2/22/2022 v2.2.19 Textual Updates Textual updates to data format headers and a parameter alternate name.
2/4/2022 v2.2.18 Spelling Update Fixed a spelling mistake in the parameter definitions.
1/28/2022 v2.2.17 Unblocked Data Parameter Unblocked the insolation clearness indexes data parameters.
1/25/2022 v2.2.16 System Enhancements and Bugfixes Changed the package managers from conda to mamba, corrected internal reference paths to resources, updated the services Cross-Origin Resource Sharing (CORS) settings, fixed spelling mistake in OpenAPI Uniform Resource Identifier (URI) descriptions, and blocked parameters with issues from irradiance bug.
12/6/2021 v2.2.15 Corrected Parameters Bugs Corrected a bug with the display of the cloud optical depth parameters.
11/17/2021 v2.2.14 Updated Parameters Information Updated the parameters to display units and availability information and corrected a bug with regional radiation requests.
11/3/2021 v2.2.13 Updates for Future Parameters Updated some data field names for future data parameters.
10/19/2021 v2.2.12 Compression for Responses Implemented Brotli & Gzip compression for response objects and server settings updates to improve performance.
10/12/2021 v2.2.11 Response Format Fixes Implemented updates to the data headers and prepared for future parameters.
10/4/2021 v2.2.10 ICASA parameter Lookup Added an ICASA parameter lookup to improve user experience when searching for parameters.
9/30/2021 v2.2.9 LST Conversation Update Corrected an hour offset issue with the Local Solar Time (LST) time standard.
9/29/2021 v2.2.8 Dynamic Date Re-Rendering Added support for YYYY dates to be converted to YYYYMMDD allowing easier transition between API temporal levels.
9/28/2021 v2.2.7 Core System Enhancements Enhancements to resources allocation, service scaling, and improved input/output performance.
9/22/2021 v2.2.6 Response Headers: App Version Added the application version to the response headers.
9/22/2021 v2.2.5 Response Headers: Timestamps Corrected the rounding for data parameters and updated the response headers to include timestamps for logging.
9/16/2021 v2.2.4 Dynamically Change Parameters Added a setting to map common names to POWER's parameters and dynamically change within the API.
9/14/2021 v2.2.3 Unblocked Precipitation Updated parameters and added unblocked precipitation.
8/24/2021 v2.2.2 Parameters Values Override Added a setting to override a parameter values forcing a missing data response for specific data values.
8/9/2021 v2.2.1 Improved Response Structure Improved the responses timeout, response header attributes, ICASA format updates, and other user reported bug fixes.
7/9/2021 v2.2.0 Production Starting Point Starting point for the public production release including, updates from the beta period, and an updated backend datastore.
Date Version Title Description
4/13/2022 v2.2.19 Enabled 2021 Data Enabled 2021 data and code enhancements to enhance response headers.
4/06/2022 v2.2.18 Code Enhancements Code enhancements to support future migrations.
3/15/2022 v2.2.17 Data Fix and Code Enhancements Added a value override for irradiance components and code enhancements.
2/22/2022 v2.2.16 Textual Updates Textual updates to data format headers and a parameter alternate name.
2/4/2022 v2.2.15 Spelling Update Fixed a spelling mistake in the parameter definitions.
1/28/2022 v2.2.14 Unblocked Data Parameter Unblocked the insolation clearness indexes data parameters.
1/25/2022 v2.2.13 System Enhancements and Bugfixes Changed the package managers from conda to mamba, corrected internal reference paths to resources, updated the services Cross-Origin Resource Sharing (CORS) settings, fixed spelling mistake in OpenAPI Uniform Resource Identifier (URI) descriptions, and blocked parameters with issues from irradiance bug.
12/6/2021 v2.2.12 Corrected Infinite Values Bug Used the override null-set for to correct bug with cloud optical depth and corrected the infinite values in JSON response bug.
11/17/2021 v2.2.11 Updated Parameters Information Updated the parameters to include units and availability information and corrected a bug with regional radiation requests.
11/3/2021 v2.2.10 Updates for Future Parameters Updated some data field names for future data parameters.
10/19/2021 v2.2.9 Compression for Responses Implemented Brotli & Gzip compression for response objects and server settings updates to improve performance.
10/12/2021 v2.2.8 Response Format Fixes Implemented JSON and Xarray format fixes.
10/4/2021 v2.2.7 Updated Minimum Region Range Updated the minimum region range requirement to correct errors from the Data Access Viewer (DAV).
9/28/2021 v2.2.6 Core System Enhancements Enhancements to resources allocation, service scaling, and improved input/output performance.
9/22/2021 v2.2.5 Response Headers: App Version Added the application version to the response headers.
9/21/2021 v2.2.4 Response Headers: Timestamps Corrected the rounding for data parameters and updated the response headers to include timestamps for logging.
9/16/2021 v2.2.3 Dynamically Change Parameters Added a setting to map common names to POWER's parameters and dynamically change within the API.
8/24/2021 v2.2.2 Parameters Values Override Added a setting to override a parameter values forcing a missing data response for specific data values.
8/9/2021 v2.2.1 Improved Response Structure Improved the responses timeout, response header attributes, and other user reported bug fixes.
7/9/2021 v2.2.0 Production Starting Point Starting point for the public production release including, updates from the beta period, and an updated backend datastore.
Date Version Title Description
4/13/2022 v2.2.20 Enabled 2021 Data Enabled 2021 data and code enhancements to enhance response headers.
4/06/2022 v2.2.19 Code Enhancements Code enhancements to support future migrations.
3/15/2022 v2.2.18 Data Fix and Code Enhancements Added a value override for irradiance components and code enhancements.
2/22/2022 v2.2.17 Textual Updates Textual updates to data format headers and a parameter alternate name.
2/4/2022 v2.2.16 Spelling Update Fixed a spelling mistake in the parameter definitions.
1/28/2022 v2.2.15 Unblocked Data Parameter Unblocked the insolation clearness indexes data parameters.
1/25/2022 v2.2.14 System Enhancements and Bugfixes Changed the package managers from conda to mamba, corrected internal reference paths to resources, updated the services Cross-Origin Resource Sharing (CORS) settings, fixed spelling mistake in OpenAPI Uniform Resource Identifier (URI) descriptions, blocked parameters with issues from irradiance bug, and changed the default climatology period.
12/6/2021 v2.2.13 Corrected Infinite Values Bug Used the override null-set for to correct bug with cloud optical depth and corrected the infinite values in JSON response bug.
11/17/2021 v2.2.12 Updated Parameters Information Updated the parameters to include units and availability information and corrected a bug with regional radiation requests.
11/3/2021 v2.2.11 Updates for Future Parameters Updated some data field names for future data parameters.
10/19/2021 v2.2.10 Compression for Responses Implemented Brotli & Gzip compression for response objects and server settings updates to improve performance.
10/12/2021 v2.2.9 Response Format Fixes Implemented JSON and Xarray format fixes.
10/4/2021 v2.2.8 Updated Minimum Region Range Updated the minimum region range requirement to correct errors from the Data Access Viewer (DAV).
9/28/2021 v2.2.7 Core System Enhancements Enhancements to resources allocation, service scaling, and improved input/output performance.
9/22/2021 v2.2.6 Response Headers: App Version Added the application version to the response headers.
9/22/2021 v2.2.5 Response Headers: Timestamps Corrected the rounding for data parameters and updated the response headers to include timestamps for logging.
9/17/2021 v2.2.4 Parameter Bug Fixes Completed some parameter bug fixes.
9/16/2021 v2.2.3 Dynamically Change Parameters Added a setting to map common names to POWER's parameters and dynamically change within the API.
8/24/2021 v2.2.2 Parameters Values Override Added a setting to override a parameter values forcing a missing data response for specific data values.
8/9/2021 v2.2.1 Improved Response Structure Improved the responses timeout, response header attributes, and other user reported bug fixes.
7/9/2021 v2.2.0 Production Starting Point Starting point for the public production release including, updates from the beta period, and an updated backend datastore.

Application APIs

The APIs that return user specified reports and validation products that use the Temporal APIs. Application API Services

Please select a service name above to explore the version history of POWER's services.

Service Date Version Title Description
Anomalies 4/13/2022 v2.2.11 Enabled 2021 Data Enabled 2021 data and code enhancements to enhance response headers.
Indicators 4/13/2022 v2.2.6 Enabled 2021 Data Enabled 2021 data and code enhancements to enhance response headers.
Windrose 4/13/2022 v2.2.13 Updated Response Headers Code updates for enhanced response headers.
Zones 4/13/2022 v2.2.12 Enabled 2021 Data Enabled 2021 data and code enhancements to enhance response headers.
Date Version Title Description
4/13/2022 v2.2.11 Enabled 2021 Data Enabled 2021 data and code enhancements to enhance response headers.
4/06/2022 v2.2.10 Code Enhancements Code enhancements to support future migrations.
3/15/2022 v2.2.9 Code Enhancements Added code enhancements to support efficient hosting of services.
2/22/2022 v2.2.8 Textual Updates Textual updates to data format headers and a parameter alternate name.
2/4/2022 v2.2.7 Spelling Update Fixed a spelling mistake in the parameter definitions.
1/28/2022 v2.2.6 Unblocked Data Parameter Unblocked the insolation clearness indexes data parameters.
1/25/2022 v2.2.5 System Enhancements Changed the package managers from conda to mamba, corrected internal reference paths to resources, and updated the services Cross-Origin Resource Sharing (CORS) settings.
11/17/2021 v2.2.4 Updated Parameters Information Updated the parameters to include units and availability information.
11/4/2021 v2.2.3 Climate Toolkit Visualizations Added more climate toolkit visualizations and architecture.
10/21/2021 v2.2.2 New Templates Architecture Updated Bokeh plotting package to 2.4.1 and added new templates with enhanced architecture.
8/9/2021 v2.2.1 Improved Response Structure Improved the responses timeout, response header attributes, and other user reported bug fixes.
6/17/2021 v2.2.0 Production Starting Point Starting point for the public production release including, updates from the beta period, and an updated backend datastore.
Date Version Title Description
4/13/2022 v2.2.6 Enabled 2021 Data Enabled 2021 data and code enhancements to enhance response headers.
4/06/2022 v2.2.5 Code Enhancements Code enhancements to support future migrations.
3/15/2022 v2.2.4 Code Enhancements Added code enhancements to support efficient hosting of services.
1/25/2022 v2.2.3 System Enhancements Changed the package managers from conda to mamba, corrected internal reference paths to resources, and updated the services Cross-Origin Resource Sharing (CORS) settings.
10/21/2021 v2.2.2 Response Headers Updates Updated the response headers to include timestamps for logging.
8/9/2021 v2.2.1 Improved Response Structure Improved the responses timeout, response header attributes, and other user reported bug fixes.
6/17/2021 v2.2.0 Production Starting Point Starting point for the public production release including, updates from the beta period, and an updated backend datastore.
Date Version Title Description
4/13/2022 v2.2.13 Updated Response Headers Code updates for enhanced response headers.
4/06/2022 v2.2.12 Code Enhancements Code enhancements to support future migrations.
3/15/2022 v2.2.11 Code Enhancements Added code enhancements to support efficient hosting of services.
2/22/2022 v2.2.10 Textual Updates Textual updates to data format headers and a parameter alternate name.
1/25/2022 v2.2.9 System Enhancements Changed the package managers from conda to mamba, corrected internal reference paths to resources, and updated the services Cross-Origin Resource Sharing (CORS) settings.
10/19/2021 v2.2.8 Compression for Responses Implemented Brotli & Gzip compression for response objects and server settings updates to improve performance.
10/19/2021 v2.2.7 Spelling Updates Fixed some spelling mistakes in code.
9/29/2021 v2.2.6 Dynamic Date Re-Rendering Added support for YYYY dates to be converted to YYYYMMDD allowing easier transition between API temporal levels.
9/28/2021 v2.2.5 Core System Enhancements Enhancements to resources allocation, service scaling, and improved input/output performance.
9/22/2021 v2.2.4 Response Headers: App Version Added the application version to the response headers.
9/22/2021 v2.2.3 Response Headers: Timestamps Corrected the rounding for data parameters and updated the response headers to include timestamps for logging.
9/16/2021 v2.2.2 JSON Format Updates Updates to the POWER JSON format.
8/9/2021 v2.2.1 Improved Response Structure Improved the responses timeout, response header attributes, and other user reported bug fixes.
6/23/2021 v2.2.0 Production Starting Point Starting point for the public production release including, updates from the beta period, and an updated backend datastore.
Date Version Title Description
4/13/2022 v2.2.12 Enabled 2021 Data Enabled 2021 data and code enhancements to enhance response headers.
4/06/2022 v2.2.11 Code Enhancements Code enhancements to support future migrations.
3/15/2022 v2.2.10 Code Enhancements Added code enhancements to support efficient hosting of services.
2/22/2022 v2.2.9 Textual Updates Textual updates to data format headers and a parameter alternate name.
1/25/2022 v2.2.8 System Enhancements Changed the package managers from conda to mamba, corrected internal reference paths to resources, and updated the services Cross-Origin Resource Sharing (CORS) settings.
10/19/2021 v2.2.7 Compression for Responses Implemented Brotli & Gzip compression for response objects and server settings updates to improve performance.
10/19/2021 v2.2.6 Spelling Updates Fixed some spelling mistakes in code.
9/28/2021 v2.2.5 Core System Enhancements Enhancements to resources allocation, service scaling, and improved input/output performance.
9/22/2021 v2.2.4 Response Headers: App Version Added the application version to the response headers.
9/22/2021 v2.2.3 Response Headers: Timestamps Corrected the rounding for data parameters and updated the response headers to include timestamps for logging.
9/16/2021 v2.2.2 JSON Format Updates Updates to the POWER JSON format.
8/9/2021 v2.2.1 Improved Response Structure Improved the responses timeout, response header attributes, and other user reported bug fixes.
6/28/2021 v2.2.0 Production Starting Point Starting point for the public production release including, updates from the beta period, and an updated backend datastore.

Release Notes

Data Version 9.x.x

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 and 2) enhances traceability to source data. Specifically, the underling data sources 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 data source'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 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 (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 = %