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:
- Date of change
- TVersion Number
- Title
- Detailed Description
- 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 | 03/08/2023 | v2.2.9 | Added ORR Announcement | Added a notice for the AWS Open Data Registry Website. |
DAV | 11/04/2022 | v2.3.14 | Added DAVe Beta Announcement | Added a notice to direct users to the Data Access Viewer Enhanced (DAVe) Beta Website. |
Docs | 05/23/2023 | v2.2.21 | Content Update | Added FAQ for data units clarifying difference between API and Zarr access. |
Dashboards | 05/23/2022 | v2.1.4 | System Update | Upgraded the backend packages versions. |
API Pages | 04/06/2022 | v2.0.3 | Branding Update | Corrected the POWER logo. |
DAVe | 05/02/2023 | v2.0.8-beta | Update Packages for Usability | Updated the frontend end packages for usability enhancements. |
Date | Version | Title | Description |
---|---|---|---|
03/08/2023 | v2.2.9 | Added ODR Announcement | Added a notice for the AWS Open Data Registry Website. |
11/04/2022 | v2.2.8 | Added DAVe Beta Announcement | Added a banner to direct users to the Data Access Viewer Enhanced (DAVe) Beta Website. |
08/05/2022 | v2.2.7 | Added GloCo Page | Added Global Community Summit 2022 webpage. |
05/23/2022 | v2.2.6 | Data Download Page | Added a direct data download page. |
04/06/2022 | v2.2.5 | Branding Update | Corrected the POWER logo. |
03/15/2022 | v2.2.4 | Updated Sitemap | Updated the sitemap. |
02/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. |
08/09/2021 | v2.2.1 | Updated Site Structure | Updated the path for the sitemap and updated robots. |
08/05/2021 | v2.2.0 | Removed the Beta References | Removed the beta references from the content and resource paths. |
07/19/2021 | v2.1.3 | Reorganized Website Content | Moved the team page to documentation and corrected resource paths. |
07/06/2021 | v2.1.1 | Corrected Spelling Mistakes | Corrected spelling mistakes in website content. |
05/11/2021 | v2.1.0 | Reorganized Content Websites | Moved publications and release notes to the documentation pages. |
04/27/2021 | v2.0.2 | Added Earthdata User Forum | Added the Earthdata User Forum link to the homepage. |
03/04/2021 | v2.0.1 | Changed Documentation References | Changed the references to documentation content and updated data sources. |
01/20/2021 | v2.0.0 | Documentation Starting Point | This is the starting point for the homepage website. |
Date | Version | Title | Description |
---|---|---|---|
11/04/2022 | v2.3.14 | Added DAVe Beta Announcement | Added a notice to direct users to the Data Access Viewer Enhanced (DAVe) Beta Website. |
08/25/2022 | v2.3.13 | Point Widget Bug Fix | Updated the point widget to allow for improved usability. |
08/19/2022 | v2.3.12 | Widget Usability Enhancements | Limited to 5 parameters and 10 years for hourly. |
08/18/2022 | v2.3.11 | Min Max Download Range | Fixed widget not allowing the max download range. |
08/11/2022 | v2.3.10 | Disabled Climatology Global | Temporarily disabled climatology global widget until bugs are fixed for this endpoint. |
04/13/2022 | v2.3.9 | Enabled 2021 Data | Enabled 2021 data for access by the widgets. |
04/06/2022 | v2.3.8 | Branding Update | Corrected the POWER logo. |
02/22/2022 | v2.3.7 | Branding and Text Updates | Updated to the new POWER logo and icon and text updates to landing pages. |
01/25/2022 | v2.3.6 | Updated Climatology Range | Updated default climatology range improve usability. |
11/02/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/04/2021 | v2.3.3 | Global Parameter Bugfix | Fixed the parameter drop-down for global spatial option. |
09/16/2021 | v2.3.2 | Regional Time Range Bugfix | Added Regional Day Limit and Fixed Time Ranges. |
08/25/2021 | v2.3.1 | Date Range Update | Update the date range for the reports. |
08/06/2021 | v2.3.0 | Added Regional | Added regional widget and removed beta references. |
03/11/2021 | v2.2.0 | Custom Climatology Update | Updated the custom climatology groups. |
01/05/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'. |
05/01/2020 | v1.1.4 | Documentation Branding Updates | Updates to documentation branding, and resource links. |
11/01/2019 | v1.1.3 | Basemap Gallery | Enabled the Basemap Gallery to help users visualize locations. |
02/01/2019 | v1.1.1 | Updated Times Available | Updated the start and end dates for support Near Real Time (NRT) data access. |
02/01/2019 | v1.1.1 | Error Handling Messages | Updated the widgets error handling messages. |
12/01/2018 | v1.1.0 | Equator Facing Tilted Surfaces | Added minimum and maximum Solar Irradiance for Equator Facing Tilted Surfaces within the Single Point widget. |
08/01/2018 | v1.0.10 | Additional Data Parameters | Added additional solar and meteorological data parameters to groups. |
05/01/2018 | v1.0.8 | Updated Parameters Groups | Updated parameters groups for the widgets; similar to the previous POWER websites and apps. |
05/01/2018 | v1.0.9 | Thermal Zones Visualization | Added Thermal Zones and Thermal Moisture Zones to the Layer List widget. |
02/01/2018 | v1.0.7 | Global Climatology Visualization | Added Layer List Widget to visualize global climatological parameters on a web map. |
Date | Version | Title | Description |
---|---|---|---|
05/02/2023 | v2.0.8-beta | Update Packages for Usability | Updated the frontend end packages for usability enhancements. |
04/20/2023 | v2.0.7-beta | Data Downloads And Layout Enhancements | Climate Design Conditions table downloads. Improvements to the following: Parameter info panel, panel and chart layouts, groupings for available parameters. |
03/08/2023 | v2.0.6-beta | Climate Indicators Enhancements | Added a climate indicators enhancements and webpage layout updates. |
03/25/2022 | v2.0.5-beta | API Visualization Updates | Visualization and usability enhancements for API requests. |
01/19/2023 | v2.0.4-beta | Web Browser Usability Fixes | Web browser usability updates and architecture updates. |
11/08/2022 | v2.0.3-beta | Build Package Updates | Updates for the build to load. |
11/07/2022 | v2.0.2-beta | System Bug Updates | Updates from Team and User feedback. |
10/27/2022 | v2.0.1-beta | System Bug Updates | Updates from Team and User feedback. |
10/21/2022 | v2.0.0-beta | System Bug Updates | Updates from Team and User feedback. |
Date | Version | Title | Description |
---|---|---|---|
05/23/2023 | v2.2.21 | Content Update | Added FAQ for data units clarifying difference between API and Zarr access. |
04/25/2023 | v2.2.20 | Content Update | Added wind equation and more versioning tracking information. |
03/16/2023 | v2.2.19 | Content Update | Added more versioning tracking information. |
03/8/2023 | v2.2.18 | Content Update | Added more versioning tracking information. |
11/04/2022 | v2.2.17 | Added DAVe Beta Announcement | Added a banner to direct users to the Data Access Viewer Enhanced (DAVe) Beta Website. |
08/22/2022 | v2.2.16 | Content Update | Added more versioning tracking information. |
06/06/2022 | v2.2.15 | Content Update | Added more versioning tracking information. |
05/31/2022 | v2.2.14 | Content Update | Added new Team Members and added AWS access instructions. |
05/23/2022 | v2.2.13 | Content Update | Added more versioning tracking information. |
04/06/2022 | v2.2.12 | Content Update | Added more versioning tracking information. |
03/16/2022 | v2.2.11 | Content Update | Added more versioning tracking information. |
03/15/2022 | v2.2.10 | Content Update | Added more versioning tracking information. |
02/22/2022 | v2.2.9 | POWER Branding and Text Updates | Updated to the new POWER logo and icon and text updates. |
02/04/2022 | v2.2.8 | Content Update | Added more versioning tracking information. |
01/28/2022 | v2.2.7 | Content Update | Added more versioning tracking information. |
01/25/2022 | v2.2.6 | Content Update | Updated some notes to improve usability, added more versioning tracking information, and updated the publications. |
12/06/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/04/2021 | v2.2.3 | Updated Services Section | Updated the services section content for OPeNDAP changes. |
09/16/2021 | v2.2.2 | Documentation Enhancements | Added usability notes and updates to content. |
08/24/2021 | v2.2.1 | Documentation Readability Updates | Documentation updates to enhance readability of methodology. |
08/09/2021 | v2.2.0 | Reorganized Website Content | Moved team members to the documentation pages and corrected resource paths. |
07/12/2021 | v2.1.2 | Enhanced Publications Tracking | Added enhanced publications, conferences, and references tracking. |
06/14/2021 | v2.1.1 | Updated Validation Documentation | Updates to the validation documentation in the data methodology. |
05/11/2021 | v2.1.0 | Reorganized Content Websites | Moved publications and release notes to the documentation pages. |
03/04/2021 | v2.0.2 | Updated Validation Documentation | Updates to the validation documentation in the data methodology. |
02/23/2021 | v2.0.1 | Updated Documentation Theme | Updated the documentation theme to a new version. |
01/21/2021 | v2.0.0 | Documentation Starting Point | This is the starting point for the documentation. |
Date | Version | Title | Description |
---|---|---|---|
05/23/2022 | v2.1.4 | System Update | Upgraded the backend packages versions. |
04/06/2022 | v2.1.3 | Branding Update | Corrected the POWER logo. |
02/22/2022 | v2.1.2 | Branding Update | Updated to the new POWER logo and icon. |
08/05/2021 | v2.1.1 | Removed the Beta References | Removed the beta references from the content and resource paths. |
07/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 |
---|---|---|---|
04/06/2022 | v2.0.3 | Branding Update | Corrected the POWER logo. |
02/22/2022 | v2.0.2 | Branding Update | Updated to the new POWER logo and icon. |
08/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 |
---|---|---|---|
08/22/2022 | v9.6.12 | Added Climatology Dataset | Added Climatology dataset for Hourly-based Solar Horizon Angle. |
Date | Version | Title | Description |
---|---|---|---|
08/22/2022 | v9.6.12 | Added Climatology Dataset | Added Climatology dataset for Hourly-based Solar Horizon Angle. |
08/19/2022 | v9.6.11 | Added Climatology Dataset | Added Climatology dataset for Hourly-based Solar Azimuth Angle. |
06/06/2022 | v9.6.10 | More Battery Sizing Parameters | Added two more battery sizing parameters to the Climatology API. |
05/23/2022 | v9.6.9 | Removed Battery Sizing Parameters | Removed battery sizing parameters in favor of updated calculations from the Climatology API. |
04/13/2022 | v9.6.8 | 2021 Monthly and Annual Data | Enabled access to 2021 monthly and annual data. |
04/12/2022 | v9.6.7 | Blocked Access to Parameters | Blocked access to parameters with issues from consecutive days bug. |
01/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/01/2021 | v9.6.0 | Precipitation Correction | Reprocess MERRA-2 precipitation for all temporal levels due to a significant digits issue. |
08/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. |
08/16/2021 | v9.5.0 | Corrected Data Inversion Issue | Corrected the data issue that caused data after 2020 to be inverted. |
07/15/2021 | v9.4.0 | Hourly Meteorology Now NRT | Made the hourly meteorology data dynamically update 2 days behind Near Real Time (NRT). |
07/07/2021 | v9.3.0 | Fully Enabled NRT Data | Fully enabled the Near Real Time (NRT) processing for daily endpoints. |
07/02/2021 | v9.2.1 | Block Simultaneous Executions | Added a executer to block simultaneous executions. |
07/02/2021 | v9.2.0 | New FLASHFlux Version | Reprocessed FLASHFlux from 2021-06-01 with new data version (401401). |
06/24/2021 | v9.1.2 | NRT Appending Speed Increase | Bug fixes and speed increases to Near Real Time (NRT) appending tool. |
06/23/2021 | v9.1.1 | Hourly Dynamically Updates | Made the hourly meteorology and solar data dynamically update 3 months behind Near Real Time (NRT). |
06/16/2021 | v9.1.0 | ARD Fully Processed | Processed and stored the initial version of Analysis Ready Datasets (ARD) for use in services. |
03/31/2021 | v9.0.2 | Solar Correction | Re-processed the CERES with a correction to the solar irradiance values and included more data parameters. |
02/16/2021 | v9.0.1 | Updated Parameters Metadata | Updated the datastore's parameters metadata, like unit names, to support on the fly conversions. |
01/01/2021 | v9.0.0 | Enhanced Traceability & Compression | Enhanced traceability using source data grids and using advanced compression. |
Data Version v9.x.x
- Underling source data is updated.
- Enhanced traceability to source data.
- Improved parameter abbreviations and definitions.
- Using underlying source data's grid resolution.
- 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 | 03/19/2023 | v2.4.1 | Equation Updates | Updated the wind speed corrected equation. |
Resources | 05/19/2023 | v2.4.2 | Added Output Capabilities | Metrics tabular function to export AWS metrics tables. |
Date | Version | Title | Description |
---|---|---|---|
03/19/2023 | v2.4.1 | Equation Updates | Updated the wind speed corrected equation. |
03/08/2023 | v2.4.0 | System Maintainability Updates | Added a series of enhancements for increased maintainability. |
11/03/2022 | v2.3.4 | Unique Error Code Enhancement | Added a unique error code to HTTP 500 responses to assist in troubleshooting API issues. |
11/03/2022 | v2.3.3 | Updated Parameters | Updated parameters for enhanced usability. |
08/16/2022 | v2.3.2 | Error Response Update | Removed extra characters from url in error response to ensure the returned url string is valid. |
08/15/2022 | v2.3.1 | Visual Enhancements | Improved formatting for human reading of long name for units. |
08/01/2022 | v2.3.0 | Code Enhancements | Code enhancements and optimizations for serverless hosting. |
06/06/2022 | v2.2.20 | Updated Parameter | Updated parameters for enhanced usability. |
05/23/2022 | v2.2.19 | Updated Parameter Groups | Updated parameter groups for DAV and code updates for enhanced usability. |
04/13/2022 | v2.2.18 | Updated Response Headers | Code updates for enhanced response headers. |
04/06/2022 | v2.2.17 | Code Enhancements | Added code enhancements to support efficient hosting of services. |
03/15/2022 | v2.2.16 | Code Enhancements | Added code enhancements to support efficient hosting of services. |
02/22/2022 | v2.2.15 | Textual Updates | Textual updates to data format headers and a parameter alternate name. |
02/04/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. |
01/28/2022 | v2.2.13 | Unblocked Data Parameter | Unblocked the insolation clearness indexes data parameters. |
01/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/06/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/03/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/02/2021 | v2.2.6 | Updated Global Groupings | Updated the parameters in the global groupings. |
09/22/2021 | v2.2.5 | Response Headers: App Version | Added the application version to the response headers. |
09/22/2021 | v2.2.4 | Response Headers: Timestamps | Corrected the rounding for data parameters and updated the response headers to include timestamps for logging. |
09/16/2021 | v2.2.3 | Updated Parameter Definitions | Updates to the parameter definitions. |
08/18/2021 | v2.2.2 | Updated Parameter Definitions | Updates to the parameter definitions. |
08/09/2021 | v2.2.1 | Improved Response Structure | Improved the responses timeout, response header attributes, and other user reported bug fixes. |
07/09/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 |
---|---|---|---|
05/19/2023 | v2.4.2 | Added Output Capabilities | Metrics tabular function to export AWS metrics tables. |
05/17/2023 | v2.4.1 | File Read Update | Read metrics summary data from AWS S3 instead of local files. |
03/08/2023 | v2.4.0 | System Maintainability Updates | Added a series of enhancements for increased maintainability. |
11/03/2022 | v2.3.3 | Unique Error Code Enhancement | Added a unique error code to HTTP 500 responses to assist in troubleshooting API issues. |
11/03/2022 | v2.3.2 | Metrics Update: August 2022 | The curated metrics update through August (2022/08). |
08/16/2022 | v2.3.1 | Error Response Update | Removed extra characters from url in error response to ensure the returned url string is valid. |
08/01/2022 | v2.3.0 | Code Enhancements | Code enhancements and optimizations for serverless hosting. |
06/06/2022 | v2.2.18 | Metrics Update: May 2022 | The curated metrics update for May (2022/05). |
05/23/2022 | v2.2.17 | Metrics Update: April 2022 | The curated metrics update for April (2022/04) and code enhancements. |
04/13/2022 | v2.2.16 | Updated Response Headers | Code updates for enhanced response headers. |
04/06/2022 | v2.2.15 | Metrics Update: March 2022 | The curated metrics update for March (2022/03) and code enhancements. |
03/15/2022 | v2.2.14 | Metrics Update: February 2022 | The curated metrics update for February (2022/02) and code enhancements. |
02/22/2022 | v2.2.13 | Textual Updates | Textual updates to data format headers and a parameter alternate name. |
02/04/2022 | v2.2.12 | Metrics Update: January 2021 | The curated metrics update for January (2022/01) and data parameters count update. |
01/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/06/2021 | v2.2.10 | Metrics Update: November 2021 | The curated metrics update for November (2021/11). |
11/01/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/01/2021 | v2.2.6 | Metrics Update: September 2021 | The curated metrics update for September 2021 (2021/09). |
09/28/2021 | v2.2.5 | Metrics Update: August 2021 | The curated metrics update for August 2021 (2021/08). |
09/22/2021 | v2.2.4 | Response Headers: App Version | Added the application version to the response headers. |
09/21/2021 | v2.2.3 | Response Headers: Timestamps | Corrected the rounding for data parameters and updated the response headers to include timestamps for logging. |
08/09/2021 | v2.2.2 | Improved Response Structure | Improved the responses timeout, response header attributes, and other user reported bug fixes. |
07/16/2021 | v2.2.1 | Metrics Updates | Updated the metrics dashboards to visualize for Near Real Time (NRT) hourly meteorology data. |
07/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 | 03/21/2023 | v2.4.2 | Equation Updates | Updated the corrected atmospheric pressure equation. |
Daily | 04/22/2023 | v2.4.3 | Unit Conversion Bug Fix | Added the conversion factor for EVLAND units. |
Monthly | 04/22/2023 | v2.4.3 | Unit Conversion Bug Fix | Added the conversion factor for EVLAND units. |
Climatology | 04/26/2023 | v2.4.4 | Unit Conversion Bug Fix | Spared Temperature Range Average parameters from repeated unit conversions. |
Date | Version | Title | Description |
---|---|---|---|
03/21/2023 | v2.4.2 | Equation Updates | Updated the corrected atmospheric pressure equation. |
03/19/2023 | v2.4.1 | Equation Updates | Updated the wind speed corrected equation. |
03/08/2023 | v2.4.0 | System Maintainability Updates | Added a series of enhancements for increased maintainability. |
11/03/2022 | v2.3.5 | Unique Error Code Enhancement | Added a unique error code to HTTP 500 responses to assist in troubleshooting API issues. |
11/03/2022 | v2.3.4 | Code Enhancements | Code enhancements to support usability. |
08/16/2022 | v2.3.3 | Error Response Update | Removed extra characters from url in error response to ensure the returned url string is valid. |
08/15/2022 | v2.3.2 | Visual Enhancements | Improved formatting for human reading of long name for units, added the source to the JSON header for JSON outputs. |
08/12/2022 | v2.3.1 | Code Enhancements | Data loading improvements for standard execution. |
08/01/2022 | v2.3.0 | Code Enhancements | Code enhancements and optimizations for serverless hosting. |
06/06/2022 | v2.2.27 | Code Enhancements | Updates to support output file naming conventions. |
06/03/2022 | v2.2.26 | Hot Fix: LST Conversion Issue | Corrected the bug with the LST time conversion effecting the Hourly API only. |
05/23/2022 | v2.2.25 | Time Conversion Update | Code enhancements and LST time conversion update. |
04/13/2022 | v2.2.24 | Updated Response Headers | Code updates for enhanced response headers. |
04/06/2022 | v2.2.23 | Updated Data Formats | Updated the SAM and SRW formats based on feedback from NREL. |
03/16/2022 | v2.2.22 | API Landing Page Fix | Updated the OpenAPI Specification JSON to fix the API Landing Page. |
03/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. |
02/22/2022 | v2.2.20 | Textual Updates | Textual updates to data format headers and a parameter alternate name. |
02/04/2022 | v2.2.19 | Spelling Update | Fixed a spelling mistake in the parameter definitions. |
01/28/2022 | v2.2.18 | Unblocked Data Parameter | Unblocked the insolation clearness indexes data parameters. |
01/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/06/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/03/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/01/2021 | v2.2.11 | LST Conversation Update | Corrected an hour offset issue with the Local Solar Time (LST) time standard. |
09/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. |
09/28/2021 | v2.2.9 | Core System Enhancements | Enhancements to resources allocation, service scaling, and improved input/output performance. |
09/22/2021 | v2.2.8 | Response Headers: App Version | Added the application version to the response headers. |
09/22/2021 | v2.2.7 | Response Headers: Timestamps | Corrected the rounding for data parameters and updated the response headers to include timestamps for logging. |
09/20/2021 | v2.2.6 | Precipitation Data Available | After corrections to the underling datastore re-enabled precipitation. |
09/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. |
08/31/2021 | v2.2.4 | Direct S3 Data Access | Enabled direct S3 data access for source datastore settings. |
08/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. |
08/09/2021 | v2.2.2 | Improved Response Structure | Improved the responses timeout, response header attributes, and other user reported bug fixes. |
07/15/2021 | v2.2.1 | NRT Hourly Meteorology | Removed the truncation to enable Near Real Time (NRT) hourly meteorology data. |
07/09/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 |
---|---|---|---|
04/22/2023 | v2.4.3 | Unit Conversion Bug Fix | Added the conversion factor for EVLAND units. |
03/21/2023 | v2.4.2 | Equation Updates | Updated the corrected atmospheric pressure equation. |
03/19/2023 | v2.4.1 | Equation Updates | Updated the wind speed corrected equation. |
03/08/2023 | v2.4.0 | System Maintainability Updates | Added a series of enhancements for increased maintainability. |
11/03/2022 | v2.3.5 | Unique Error Code Enhancement | Added a unique error code to HTTP 500 responses to assist in troubleshooting API issues. |
11/03/2022 | v2.3.4 | Code Enhancements | Code enhancements to support usability. |
08/16/2022 | v2.3.3 | Error Response Update | Removed extra characters from url in error response to ensure the returned url string is valid. |
08/15/2022 | v2.3.2 | Visual Enhancements | Improved formatting for human reading of long name for units, added the source to the JSON header for JSON outputs. |
08/12/2022 | v2.3.1 | Code Enhancements | Data loading improvements for standard execution. |
08/01/2022 | v2.3.0 | Code Enhancements | Code enhancements and optimizations for serverless hosting. |
06/06/2022 | v2.2.25 | Code Enhancements | Updates to support output file naming conventions. |
05/23/2022 | v2.2.24 | Usability Enhancements | Code updates for enhanced usability. |
04/13/2022 | v2.2.23 | Updated Response Headers | Code updates for enhanced response headers. |
04/06/2022 | v2.2.22 | Code Enhancements | Code enhancements to support future migrations. |
03/15/2022 | v2.2.21 | API Landing Page Fix | Updated the OpenAPI Specification JSON to fix the API Landing Page. |
03/15/2022 | v2.2.20 | Data Fix and Code Enhancements | Added a value override for irradiance components and code enhancements. |
02/22/2022 | v2.2.19 | Textual Updates | Textual updates to data format headers and a parameter alternate name. |
02/04/2022 | v2.2.18 | Spelling Update | Fixed a spelling mistake in the parameter definitions. |
01/28/2022 | v2.2.17 | Unblocked Data Parameter | Unblocked the insolation clearness indexes data parameters. |
01/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/06/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/03/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/04/2021 | v2.2.10 | ICASA parameter Lookup | Added an ICASA parameter lookup to improve user experience when searching for parameters. |
09/30/2021 | v2.2.9 | LST Conversation Update | Corrected an hour offset issue with the Local Solar Time (LST) time standard. |
09/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. |
09/28/2021 | v2.2.7 | Core System Enhancements | Enhancements to resources allocation, service scaling, and improved input/output performance. |
09/22/2021 | v2.2.6 | Response Headers: App Version | Added the application version to the response headers. |
09/22/2021 | v2.2.5 | Response Headers: Timestamps | Corrected the rounding for data parameters and updated the response headers to include timestamps for logging. |
09/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. |
09/14/2021 | v2.2.3 | Unblocked Precipitation | Updated parameters and added unblocked precipitation. |
08/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. |
08/09/2021 | v2.2.1 | Improved Response Structure | Improved the responses timeout, response header attributes, ICASA format updates, and other user reported bug fixes. |
07/09/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 |
---|---|---|---|
04/22/2023 | v2.4.3 | Unit Conversion Bug Fix | Added the conversion factor for EVLAND units. |
03/21/2023 | v2.4.2 | Equation Updates | Updated the corrected atmospheric pressure equation. |
03/19/2023 | v2.4.1 | Equation Updates | Updated the wind speed corrected equation. |
03/08/2023 | v2.4.0 | System Maintainability Updates | Added a series of enhancements for increased maintainability. |
11/03/2022 | v2.3.5 | Unique Error Code Enhancement | Added a unique error code to HTTP 500 responses to assist in troubleshooting API issues. |
11/03/2022 | v2.3.4 | Code Enhancements | Code enhancements to support usability. |
08/16/2022 | v2.3.3 | Error Response Update | Removed extra characters from url in error response to ensure the returned url string is valid. |
08/15/2022 | v2.3.2 | Visual Enhancements | Improved formatting for human reading of long name for units, added the source to the JSON header for JSON outputs. |
08/12/2022 | v2.3.1 | Code Enhancements | Data loading improvements for standard execution. |
08/01/2022 | v2.3.0 | Code Enhancements | Code enhancements and optimizations for serverless hosting. |
06/06/2022 | v2.2.21 | Code Enhancements | Updates to support output file naming conventions. |
05/23/2022 | v2.2.20 | Usability Enhancements | Code updates for enhanced usability. |
04/13/2022 | v2.2.19 | Enabled 2021 Data | Enabled 2021 data and code enhancements to enhance response headers. |
04/06/2022 | v2.2.18 | Code Enhancements | Code enhancements to support future migrations. |
03/15/2022 | v2.2.17 | Data Fix and Code Enhancements | Added a value override for irradiance components and code enhancements. |
02/22/2022 | v2.2.16 | Textual Updates | Textual updates to data format headers and a parameter alternate name. |
02/04/2022 | v2.2.15 | Spelling Update | Fixed a spelling mistake in the parameter definitions. |
01/28/2022 | v2.2.14 | Unblocked Data Parameter | Unblocked the insolation clearness indexes data parameters. |
01/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/06/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/03/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/04/2021 | v2.2.7 | Updated Minimum Region Range | Updated the minimum region range requirement to correct errors from the Data Access Viewer (DAV). |
09/28/2021 | v2.2.6 | Core System Enhancements | Enhancements to resources allocation, service scaling, and improved input/output performance. |
09/22/2021 | v2.2.5 | Response Headers: App Version | Added the application version to the response headers. |
09/21/2021 | v2.2.4 | Response Headers: Timestamps | Corrected the rounding for data parameters and updated the response headers to include timestamps for logging. |
09/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. |
08/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. |
08/09/2021 | v2.2.1 | Improved Response Structure | Improved the responses timeout, response header attributes, and other user reported bug fixes. |
07/09/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 |
---|---|---|---|
04/26/2023 | v2.4.4 | Unit Conversion Bug Fix | Spared Temperature Range Average parameters from repeated unit conversions. |
04/22/2023 | v2.4.3 | Unit Conversion Bug Fix | Added the conversion factor for EVLAND units. |
03/21/2023 | v2.4.2 | Equation Updates | Updated the corrected atmospheric pressure equation. |
03/19/2023 | v2.4.1 | Equation Updates | Updated the wind speed corrected equation. |
03/08/2023 | v2.4.0 | System Maintainability Updates | Added a series of enhancements for increased maintainability. |
11/03/2022 | v2.3.10 | Unique Error Code Enhancement | Added a unique error code to HTTP 500 responses to assist in troubleshooting API issues. |
11/03/2022 | v2.3.9 | Tilted Surfaces Fix | Implemented the fix for the Minimum and Maximum Tilted Surfaces. |
08/24/2022 | v2.3.8 | Solar Geometry Fix | Correct a hourly solar geometry bug. |
08/22/2022 | v2.3.7 | Data Fix and Code Enhancements | Moved horizon angle data from processing to archive. |
08/19/2022 | v2.3.6 | Data Fix and Code Enhancements | Moved data from processing to archive. |
08/16/2022 | v2.3.5 | Error Response Update | Removed extra characters from url in error response to ensure the returned url string is valid. |
08/15/2022 | v2.3.4 | Visual Enhancements | Improved formatting for human reading of long name for units, added the source to the JSON header for JSON outputs. |
08/12/2022 | v2.3.3 | Code Enhancements | Disabling global endpoint temporarily to address underlying conflicts, fixed frost days bug for single point. |
08/11/2022 | v2.3.2 | Code Enhancements | Corrected issue with the battery sizing parameters. |
08/11/2022 | v2.3.1 | Code Enhancements | Corrected several bugs to improve service time and error rate: improved data loading, introduced missing parameters, limited the number of parameters per request to avoid data/memory overload. Added tests to ensure continued success. |
08/01/2022 | v2.3.0 | Code Enhancements | Code enhancements and optimizations for serverless hosting. |
06/06/2022 | v2.2.22 | Code Enhancements | Updates to support output file naming conventions. |
05/23/2022 | v2.2.21 | Usability Enhancements | Code updates for enhanced usability. |
04/13/2022 | v2.2.20 | Enabled 2021 Data | Enabled 2021 data and code enhancements to enhance response headers. |
04/06/2022 | v2.2.19 | Code Enhancements | Code enhancements to support future migrations. |
03/15/2022 | v2.2.18 | Data Fix and Code Enhancements | Added a value override for irradiance components and code enhancements. |
02/22/2022 | v2.2.17 | Textual Updates | Textual updates to data format headers and a parameter alternate name. |
02/04/2022 | v2.2.16 | Spelling Update | Fixed a spelling mistake in the parameter definitions. |
01/28/2022 | v2.2.15 | Unblocked Data Parameter | Unblocked the insolation clearness indexes data parameters. |
01/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/06/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/03/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/04/2021 | v2.2.8 | Updated Minimum Region Range | Updated the minimum region range requirement to correct errors from the Data Access Viewer (DAV). |
09/28/2021 | v2.2.7 | Core System Enhancements | Enhancements to resources allocation, service scaling, and improved input/output performance. |
09/22/2021 | v2.2.6 | Response Headers: App Version | Added the application version to the response headers. |
09/22/2021 | v2.2.5 | Response Headers: Timestamps | Corrected the rounding for data parameters and updated the response headers to include timestamps for logging. |
09/17/2021 | v2.2.4 | Parameter Bug Fixes | Completed some parameter bug fixes. |
09/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. |
08/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. |
08/09/2021 | v2.2.1 | Improved Response Structure | Improved the responses timeout, response header attributes, and other user reported bug fixes. |
07/09/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 | 03/08/2023 | v2.4.0 | System Maintainability Updates | Added a series of enhancements for increased maintainability. |
Indicators | 03/08/2023 | v2.4.0 | System Maintainability Updates | Added a series of enhancements for increased maintainability. |
Windrose | 03/08/2023 | v2.4.0 | System Maintainability Updates | Added a series of enhancements for increased maintainability. |
Zones | 03/08/2023 | v2.4.0 | System Maintainability Updates | Added a series of enhancements for increased maintainability. |
Toolkit | 03/08/2023 | v2.4.0 | System Maintainability Updates | Added a series of enhancements for increased maintainability. |
Date | Version | Title | Description |
---|---|---|---|
03/08/2023 | v2.4.0 | System Maintainability Updates | Added a series of enhancements for increased maintainability. |
11/03/2022 | v2.3.3 | Unique Error Code Enhancement | Added a unique error code to HTTP 500 responses to assist in troubleshooting API issues. |
11/03/2022 | v2.3.2 | Code Enhancements | Code enhancements to support usability. |
08/16/2022 | v2.3.1 | Error Response Update | Removed extra characters from url in error response to ensure the returned url string is valid. |
08/01/2022 | v2.3.0 | Code Enhancements | Code enhancements and optimizations for serverless hosting. |
06/06/2022 | v2.2.13 | Code Enhancements | Updates to support output file naming conventions. |
05/23/2022 | v2.2.12 | Usability Enhancements | Code updates for enhanced usability. |
04/13/2022 | v2.2.11 | Enabled 2021 Data | Enabled 2021 data and code enhancements to enhance response headers. |
04/06/2022 | v2.2.10 | Code Enhancements | Code enhancements to support future migrations. |
03/15/2022 | v2.2.9 | Code Enhancements | Added code enhancements to support efficient hosting of services. |
02/22/2022 | v2.2.8 | Textual Updates | Textual updates to data format headers and a parameter alternate name. |
02/04/2022 | v2.2.7 | Spelling Update | Fixed a spelling mistake in the parameter definitions. |
01/28/2022 | v2.2.6 | Unblocked Data Parameter | Unblocked the insolation clearness indexes data parameters. |
01/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/04/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. |
08/09/2021 | v2.2.1 | Improved Response Structure | Improved the responses timeout, response header attributes, and other user reported bug fixes. |
06/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 |
---|---|---|---|
03/08/2023 | v2.4.0 | System Maintainability Updates | Added a series of enhancements for increased maintainability. |
11/03/2022 | v2.3.6 | Unique Error Code Enhancement | Added a unique error code to HTTP 500 responses to assist in troubleshooting API issues. |
11/03/2022 | v2.3.5 | Excel Format Fix | Corrected the bug with the Excel format response. |
11/03/2022 | v2.3.4 | Enabled 2021 Data | Enabled access to 2021 data for the Reports. |
08/16/2022 | v2.3.3 | Error Response Update | Removed extra characters from url in error response to ensure the returned url string is valid, fixed year range issue and response. |
08/16/2022 | v2.3.2 | Code Enhancements | Several bug fixes and optimizations for serverless hosting, moved external network access to the datastore, utilized pandas for better processing speed, improved formatting for human reading of long name for units, added the source to the JSON header for JSON outputs. |
08/12/2022 | v2.3.1 | Capability Enhancements | Data loading improvements for standard execution, added ability to export xslx from notebook. |
08/01/2022 | v2.3.0 | Enhanced Indicators Calculations | Enhanced the indicators calculations to use a single source of data and updated equations. |
05/23/2022 | v2.2.7 | Usability Enhancements | Code updates for enhanced usability. |
04/13/2022 | v2.2.6 | Enabled 2021 Data | Enabled 2021 data and code enhancements to enhance response headers. |
04/06/2022 | v2.2.5 | Code Enhancements | Code enhancements to support future migrations. |
03/15/2022 | v2.2.4 | Code Enhancements | Added code enhancements to support efficient hosting of services. |
01/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. |
08/09/2021 | v2.2.1 | Improved Response Structure | Improved the responses timeout, response header attributes, and other user reported bug fixes. |
06/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 |
---|---|---|---|
03/08/2023 | v2.4.0 | System Maintainability Updates | Added a series of enhancements for increased maintainability. |
11/03/2022 | v2.3.4 | Unique Error Code Enhancement | Added a unique error code to HTTP 500 responses to assist in troubleshooting API issues. |
11/03/2022 | v2.3.3 | Code Enhancements | Code enhancements to support usability. |
08/16/2022 | v2.3.2 | Error Response Update | Removed extra characters from url in error response to ensure the returned url string is valid. |
08/15/2022 | v2.3.1 | Visual Enhancements | Added the source to the JSON header for JSON outputs. |
08/01/2022 | v2.3.0 | Code Enhancements | Code enhancements and optimizations for serverless hosting. |
06/06/2022 | v2.2.15 | Code Enhancements | Updates to support output file naming conventions. |
05/23/2022 | v2.2.14 | Usability Enhancements | Code updates for enhanced usability. |
04/13/2022 | v2.2.13 | Updated Response Headers | Code updates for enhanced response headers. |
04/06/2022 | v2.2.12 | Code Enhancements | Code enhancements to support future migrations. |
03/15/2022 | v2.2.11 | Code Enhancements | Added code enhancements to support efficient hosting of services. |
02/22/2022 | v2.2.10 | Textual Updates | Textual updates to data format headers and a parameter alternate name. |
01/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. |
09/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. |
09/28/2021 | v2.2.5 | Core System Enhancements | Enhancements to resources allocation, service scaling, and improved input/output performance. |
09/22/2021 | v2.2.4 | Response Headers: App Version | Added the application version to the response headers. |
09/22/2021 | v2.2.3 | Response Headers: Timestamps | Corrected the rounding for data parameters and updated the response headers to include timestamps for logging. |
09/16/2021 | v2.2.2 | JSON Format Updates | Updates to the POWER JSON format. |
08/09/2021 | v2.2.1 | Improved Response Structure | Improved the responses timeout, response header attributes, and other user reported bug fixes. |
06/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 |
---|---|---|---|
03/08/2023 | v2.4.0 | System Maintainability Updates | Added a series of enhancements for increased maintainability. |
11/03/2022 | v2.3.5 | Unique Error Code Enhancement | Added a unique error code to HTTP 500 responses to assist in troubleshooting API issues. |
11/03/2022 | v2.3.4 | Code Enhancements | Code enhancements to support usability. |
08/16/2022 | v2.3.3 | Error Response Update | Removed extra characters from url in error response to ensure the returned url string is valid. |
08/15/2022 | v2.3.2 | Visual Enhancements | Added the source to the JSON header for JSON outputs. |
08/12/2022 | v2.3.1 | Code Simplifications | Temporarily disabling global endpoint to address underlying conflicts, update to access local data more quickly. |
08/01/2022 | v2.3.0 | Code Enhancements | Code enhancements and optimizations for serverless hosting. |
06/06/2022 | v2.2.14 | Code Enhancements | Updates to support output file naming conventions. |
05/23/2022 | v2.2.13 | Usability Enhancements | Code updates for enhanced usability. |
04/13/2022 | v2.2.12 | Enabled 2021 Data | Enabled 2021 data and code enhancements to enhance response headers. |
04/06/2022 | v2.2.11 | Code Enhancements | Code enhancements to support future migrations. |
03/15/2022 | v2.2.10 | Code Enhancements | Added code enhancements to support efficient hosting of services. |
02/22/2022 | v2.2.9 | Textual Updates | Textual updates to data format headers and a parameter alternate name. |
01/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. |
09/28/2021 | v2.2.5 | Core System Enhancements | Enhancements to resources allocation, service scaling, and improved input/output performance. |
09/22/2021 | v2.2.4 | Response Headers: App Version | Added the application version to the response headers. |
09/22/2021 | v2.2.3 | Response Headers: Timestamps | Corrected the rounding for data parameters and updated the response headers to include timestamps for logging. |
09/16/2021 | v2.2.2 | JSON Format Updates | Updates to the POWER JSON format. |
08/09/2021 | v2.2.1 | Improved Response Structure | Improved the responses timeout, response header attributes, and other user reported bug fixes. |
06/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. |
Date | Version | Title | Description |
---|---|---|---|
03/08/2023 | v2.4.0 | System Maintainability Updates | Added a series of enhancements for increased maintainability. |
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.