Commit 7a31a10
Merging "Release/v1" branch to main (#129)
## Description
This PR merges The `release/v1` branch into the `main` branch.
The `release/v1` branch was split off from `main` about a year ago, with the intention to make major rules and name changes to improve the consistency and maintainability of both the rules and the names, without giving major inconveniences/disruption to those currently making use of the main branch. After a year of discussion and changes, it is time to bring these changes to their final resting place in the main branch.
The major breaking and/or non-back-compatible changes can be summarized as such (See the subsections below for specific details about these changes):
- the physics `kind` field is removed
- the `long_name` field is changed to `description`
- Several changes to particular terms and components of existing names have been made
After this PR is merged, a `v1.0.0` tag will be created, representing the first true "versioned" version of the ESM Standard Names. While more rule changes are likely in the future to resolve open and future issues, this should be a more stable jumping-off point to allow updates and reconciliation with the names in the CCPP physics repository, which has not been resolved in many years now.
For those who have not been following along with the discussion and changes related to the **v1** branch, here is a summary of each of the changes made on this branch:
### #85 First rules update, fixing misspelled standard names
This first change introduced some changes to the Rules document based on discussion in the CCPP framework regular meetings. These rules changes can be summarized as follows
- Introduced a more rigorous and standardized formula for constructing new standard names, with specific rules and definitions of each component of the name, attempting to cover all possible cases
- Introduced the concept of "suffixes" to compliment prefixes, with mixing_ratio_wrt``_Y`` being the first example
- Introduced the concept of "Reserved phrases"...for now only including "CCPP" as a reference to CCPP-specific variables
In addition, a large number of misspellings within the existing names and rules were fixed.
### #87 Second rules update in v1 branch, update several name types
This second change introduced the concept of "base names"; representing the main entity from which a standard name is constructed. Some existing prefixes (`surface_X` and `air_X`) were converted to suffixes (`X_at_surface` and `X_of_air`) to improve consistency with other existing names and rules, and some superfluous `surface` wording was removed from several names. The definitions for mixing ratios were improved, and the rules for constructing new names were updated and improved.
### #104 Add techincal specification, substitute abbreviations, include base name definitions
This third rules change included some info about technical specifications of the standard names repository, and some formatting improvements. Instances of the term `weight` were changed to `scaling_factor` to avoid potential confusion with the physical property of weight. `long_name` descriptions were added for all the new "base names" with a few minor exceptions. Some new abbreviations were defined to help shorten names. Some unused and duplicate entries were removed. Finally, CCPP-specific variables were consolidated into their own section.
### #116 Rename long_name --> description, update description rules, expand list of abbreviations
This fourth change renamed the `long_name` field to `description`, clarifying that this field should be unique, and improving/fixing some existing descriptions. Some more duplicate entries were removed. Some additional new abbreviations were defined to continue shortening names. Finally, continued defining more abbreviations to help shorten standard names further.
### #124 Remove `kind` entry, clarify rules for units and disallowed terms
This fifth and final change to the v1 branch (aside from another PR to resolve intervening changes from the main branch) updated the rules to clarify disallowed terms and the role of `units`, and removed the `kind` entry. The `constants` section was organized alphabetically, and changed some names regarding `dry_air`.
## Issues
Resolves
- #48
- #68
- #94
- #102
Also reference already-closed issues:
- #92
- #93
- #95
- #103
---------
Co-authored-by: Jesse Nusbaumer <nusbaume@ucar.edu>
Co-authored-by: Dom Heinzeller <dom.heinzeller@icloud.com>1 parent 389d9b6 commit 7a31a10
File tree
10 files changed
+7145
-5912
lines changed- .github/workflows
- tools
10 files changed
+7145
-5912
lines changed| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
25 | 25 | | |
26 | 26 | | |
27 | 27 | | |
28 | | - | |
| 28 | + | |
29 | 29 | | |
30 | | - | |
| 30 | + | |
| 31 | + | |
31 | 32 | | |
32 | 33 | | |
33 | 34 | | |
| |||
Large diffs are not rendered by default.
0 commit comments