SuperDARN / dswg-published-docs

A repo for public information from the Data Standards Working Group
1 stars 0 forks source link

FITACF, GRID, MAP "undocumented" standard formats #2

Open mts299 opened 4 years ago

mts299 commented 4 years ago

Submitter Name and Institution

Name: Marina Schmidt Institution: Superdarn Canada, University of Saskatchewan Preferred contact method (e.g., email): marina.t.schmidt@gmail.com

Purpose of Standardization

Please identify why you would like to standardize the format you are proposing.

Production Method

RAWACF (from radars) -> RST make_grid (fitacf 2.5) -> FITACF -> (make_grid) -> GRID -> (bunch of map functions) -> MAP files Using RST all the above formats can be produced. Focusing mainly on fields currently used in these formats as a standard not the standard processing values. All formats produce "common" plots:

Other scientists use the velocity values in FITACF (amongst different fitted values), GRID files provide line of sight velocities for geolocational coordinates, Convection maps similar to GRID also provide statistical analysis and incorporations of plasma drift information (IMF, HMB)

Access to Production Method

Globus or BAS or you can produce the files from RST using rawacf file described in the RST tutorials: https://radar-software-toolkit-rst.readthedocs.io/en/latest/

It is verified by many years of scientists using the files.

Requirements of Data Format

Currently in the works but FITACF has been documented: https://radar-software-toolkit-rst.readthedocs.io/en/docs-fitacf_description/references/general/fitacf/

DMAP is a binary format that is accepted as a standard as it is used with RST. documentation: https://superdarn.github.io/rst/superdarn/src.doc/rfc/0006.html (also in the process of being updated) To read/write this format you can use pyDARN RST can read a file via terminal with dmapdump and writes the file via producing the file with the above commands listed in the process. However, any manipulation with fields in terms of reading and writing is not available. pyDARN is python 3.6+ and works on all OS platforms RST is C and works on Linux and OSx (Mac). In theory, Windows can work too.

Method of Integration with Existing Formats

Distribution through Globus as it is currently available on request.

In terms of old formats, RST provides some backward compatibility; however, still undocumented formats.