ADAPT / Standard

ADAPT Standard data model issue management
https://adaptstandard.org
MIT License
6 stars 0 forks source link

File Naming in ADAPT Serialized Datasets #126

Open knelson-farmbeltnorth opened 8 months ago

knelson-farmbeltnorth commented 8 months ago

In 1 November 2023 meeting we agreed that

  1. The json "header" file shall be called "adapt.json" (all lower case)
  2. Any GeoParquet or GeoTiff files referenced can be named and nested in subdirectories at the users discretion, provided any paths specified are relative to the location of adapt.json
  3. We should identify and use standard file extensions for GeoTiff and GeoParquet files.

Open questions for additional discussion:

  1. Should we limit allowable file name characters?
  2. What are standard extensions for GeoTiff and GeoParquet?
knelson-farmbeltnorth commented 7 months ago

We identified in the prior meeting that ".parquet" is the correct extension for GeoParquet. By the same logic, it appears ".tiff" is correct for TIFF.

I would propose we limit filenames to A-Z, a-z, 0-9 and "_".

crutt commented 7 months ago

During today's meeting, we discussed using a section similar to the Avoid Special Characters section from NIST Electronic File Organization Tips

knelson-farmbeltnorth commented 7 months ago

Decision in 29 November 2023 meeting to take a file name blacklist rather than whitelist approach and describe characters to avoid as @crutt points out above.

Agreement on ".parquet" and ".tiff" as the proper extensions.