Skip to content

Commit

Permalink
Merge pull request cf-convention#478 from Dave-Allured/period-hyphen
Browse files Browse the repository at this point in the history
Allow period and hyphen in attribute names
  • Loading branch information
sethmcg authored Mar 1, 2024
2 parents 303b28b + 4ff7ddb commit 20dca5b
Show file tree
Hide file tree
Showing 3 changed files with 3 additions and 0 deletions.
1 change: 1 addition & 0 deletions ch02.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,7 @@ By the word _letters_ we mean the standard ASCII letters uppercase `A` to `Z` an
By the word _digits_ we mean the standard ASCII digits `0` to `9`, and similarly _underscores_ means the standard ASCII underscore `_`.
Note that this is in conformance with the COARDS conventions, but is more restrictive than the netCDF interface which allows almost all Unicode characters encoded as multibyte UTF-8 characters (link:$$https://docs.unidata.ucar.edu/nug/current/file_format_specifications.html$$[NUG Appendix B]).
The netCDF interface also allows leading underscores in names, but the NUG states that this is reserved for system use.
ASCII period (.) and ASCII hyphen (-) are also allowed in attribute names only.

Case is significant in netCDF names, but it is recommended that names should not be distinguished purely by case, i.e., if case is disregarded, no two names should be the same.
It is also recommended that names should be obviously meaningful, if possible, as this renders the file more effectively self-describing.
Expand Down
1 change: 1 addition & 0 deletions conformance.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ See https://github.com/ugrid-conventions/ugrid-conventions for the UGRID conform
*Recommendations:*

* Variable, dimension and attribute names should begin with a letter and be composed of letters (A-Z, a-z), digits (0-9), and underscores(_). This corresponds to ASCII characters in the decimal ranges (65-90), (97-122), (48-57), and (95). The corresponding Unicode codepoints are (U+0041-U+005A), (U+0061-U+007A), (U+0030-U+0039), and (U+005F).
* ASCII period (.) and ASCII hyphen (-) may also be included in attribute names only.
* No two variable names should be identical when case is ignored.

[[section-2]]
Expand Down
1 change: 1 addition & 0 deletions history.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@

=== Working version (most recent first)

* {issues}477[Issue #477]: Period and hyphen allowed in attribute names
* {issues}500[Issue #500]: Appendix B: Added a **`conventions`** string to the standard name xml file format definition

=== Version 1.11 (05 December 2023)
Expand Down

0 comments on commit 20dca5b

Please sign in to comment.