Improve names

[clbarnes]

The LabView internal docs include units and more explicit names for the fields, which would be helpful to include. Kindly provided for v9 in this comment: https://github.com/JaneliaSciComp/jeiss_fibsem_labview_control/issues/11#issuecomment-1402995031 (note this does have some errors, e.g. file length is an int64 (signed, for some reason), not a float64).

Some design goals for names:

• explicitness over terseness
  • avoid initialisations unless they're repeated and somewhat obvious to anyone who touches FIBSEM data, e.g. FIB and SEM
• include units
• use snake_case (controversial)
  • it is trivial to convert snake_case strings to camelCase/ UpperCamel, for languages which require it; not possible to convert the other way while persisting meaningful capitalisation (e.g. for units and initialisms)
  • do not add unnecessary capitalisation, i.e.
• use a character set which can easily be used as variable names in most common programming languages
  • probably avoid spaces (although these could easily be transformed to either snake or camel as necessary)
  • something matching regex ^\w[\w\d_]*$ fits most programming languages

[clbarnes]

Notably, MATLAB style guidelines do not recommend UpperCamel: https://sites.google.com/site/matlabstyleguidelines/home?authuser=0

[clbarnes]

Proposed names and some other notes: https://docs.google.com/spreadsheets/d/1ZrfpneZqF5Bv7K5IVicyDBP3aAtEOK9Ma7RU_GwFK0s/edit?usp=sharing

[clbarnes]

Seeing more implementations in the wild with names further based on the MATLAB is making me lean away from this; I think the horse has bolted. I believe the best we could do would be to include a new column in the spec TSVs which describe fields and their units.