Global Attributes

Required ISTP Complaint Global Attributes (see ISTP Documentation).

  • Data_type
  • Data_version
  • Descriptor
  • Discipline
  • Instrument_type
    bubble Note that the correct setting for riometers is Ground-Based Magnetometers, Riometers, Sounders, which is not very specific!
  • Logical_file_id
  • Logical_source
  • Logical_source_description
  • Mission_group
  • PI_affiliation
  • PI_name
  • Project (eg ISTP>International Solar-Terrestrial Physics)
  • Source_name
  • Text

Additional GAIA Required Meta Data

GAIA_version
An integer version number, indicating that the file is GAIA compliant, and to which version of the GAIA CDF standard. Attribute properties:
Data type
UINT16
bubble Is it correct that for GLORIA we mandate a GAIA version number? I think we need some kind of version number though. -- SteveMarple - 21 Feb 2007

Start_time
End_time
Although the data is timestamped it is helpful to know what range of values the data is supposed to cover. Should be CDF epoch values.
Data type
EPOCH

Instrument_class
String. For GLORIA this is riometer.
bubble BrianJackel: please suggest names for ASCs and MSPs.
Data type
CHAR or UCHAR

Required Variables

ISTP Required Variables

GAIA Required Variables

Site_code:

A site code (usally 3 or 4 letters) consisting of alphanumeric characters only (not case-sensitive), stored as an array of strings, to allow for the file containing data from multiple sites. Spaces are only permitted at the end of the site code. Variable properties:
Record variance
NOVARY
Data type
CHAR or UCHAR

Variable attributes for Site_code:

CATDESC
Site code
FIELDNAM
site_code
DICT_KEY
label>
VAR_TYPE
metadata
FORMAT
a3, or a4 as appropriate
VAR_TYPE
?

Site_name:

A site name, stored as an array of strings, to allow for the file containing data from multiple sites. Variable properties:
Record variance
NOVARY
Data type
CHAR or UCHAR

Variable attributes for Site:

CATDESC
Site name
FIELDNAM
site_name
DICT_KEY
label>
VAR_TYPE
metadata
FORMAT
a
VAR_TYPE
?

Number_of_beams [GLORIA]

An integer array (same size as Site_code) containing the number of beams stored in the CDF file for each site. The number of beams stored in the CDF file may not be the total number of beams for a given site.. Variable properties:
Data type
Preferably UINT1, UINT2 or UINT4, INT1, INT2, INT4 acceptable.
Record variance
NOVARY

Variable attributes for Number_of_beams:

CATDESC
Number of riometer beams
FIELDNAM
number of beams
DICT_KEY
label&gt>number of beams
VAR_TYPE
support_data
FORMAT
I
UNITS
' '
VALIDMIN
1
VALIDMAX
as appropriate
VAR_TYPE
support_data

Beam_number [GLORIA]

An integer array (same size as Site_code) containing the beam number. First beam is 1. For widebeams, use 1. Variable properties:
Data type
Preferably UINT1, UINT2 or UINT4, INT1, INT2, INT4 acceptable.
Record variance
NOVARY

Variable attributes for Beams:

CATDESC
Riometer Beam Number
FIELDNAM
beam
DICT_KEY
label&gt>beams
VAR_TYPE
support_data
FORMAT
I
MONOTON
INCREASE, but only if one data from one instrument is present
UNITS
' '
VALIDMIN
1
VALIDMAX
as appropriate
VAR_TYPE
support_data

Geographic_latitude

Geographic latitude identifying where the instrument is located, stored in degrees. North is positive. An array of the same size as Site_code. Variable metadata:

Record variance
NOVARY
Data type
FLOAT, REAL4, DOUBLE or REAL8

Variable attributes for =Geographic_latitude:

CATDESC
?
FIELDNAM
Geographic_latitude
DICT_KEY
?
VAR_TYPE
?
FORMAT
?
VALIDMIN
-90
VALIDMAX
90

bubble Do we want geodetic or geographic latitude/longitude? Maybe we should specify WGS84 geoid? -- SteveMarple - 21 Feb 2007

Geographic_longitude

Geographic longitude identifying where the instrument is located, in degrees. East is positive. An array of the same size as Site_code. Variable properties:

Record variance
NOVARY
Data type
FLOAT, REAL4, DOUBLE or REAL8

Variable attributes for Geographic_ongitude.

CATDESC
?
FIELDNAM
Geographic longitude
DICT_KEY
?
VAR_TYPE
?
FORMAT
?
VALIDMIN
-360
VALIDMAX
+360

Device:

A unique instrument identifier, guaranteed to be unique within a Project. Variable properties:

Record variance
NOVARY
Data type
CHAR or UCHAR
bubble What was the name we agreed for this?

Frequency [GLORIA]

Operating frequency of the riometer, in Hertz. Essential as absorption is frequency-dependent. Variable properties:
Record variance
NOVARY
Data type
FLOAT, REAL4, DOUBLE or REAL8

Variable attributes for Frequency:

CATDESC
Centre Frequency
FIELDNAM
Frequency
DICT_KEY
frequency>
UNITS
Hertz
VAR_TYPE
support_data

Bandwidth [GLORIA]

(Full-width half-maximum) operating bandwidth of the riometer. Variable properties:

Record variance
NOVARY
Data type
FLOAT, REAL4, DOUBLE or REAL8

Variable attributes for Bandwidth:

CATDESC
=Bandwidth
FIELDNAM
=bandwidth
DICT_KEY
power>bandwidth
VAR_TYPE
support_data
UNITS
Hertz

Raw_data [GLORIA]

Actual data values recorded by riometer, an array with dimensions equal to number of sites or number of beams. Not required if Absorption is present. Variable properties:

Record variance
VARY
Data type
FLOAT, REAL4, DOUBLE or REAL8. If units are ADC counts then integer data types acceptable.
Variable attributes for Raw_data:
CATDESC
Raw Signal
FIELDNAM
Raw signal power
UNITS
volts, dBm, ADC or whatever as appropriate. Please choose from the list included here if possible.
LABLAXIS
Received power
DISPLAY_TYPE
time_series
DEPEND_0
Epoch
DEPEND_1
Site
DEPEND_2
Beam_number
LABL_PTR_1
Site_code

Absorption [GLORIA]

Derived ionospheric absorption values, an array with dimensions equal to number of sites by the maximum number of beams. Not required if Raw_data is present. Variable properties:
Record variance
VARY
Data type
FLOAT, REAL4, DOUBLE or REAL8

Variable attributes for Absorption:

CATDESC
Absorption
FIELDNAM
Absorption ?
UNITS
dB Note correct case
LABLAXIS
Absorption
DISPLAY_TYPE
time_series
DEPEND_0
Epoch
DEPEND_1
Site
DEPEND_2
Beam_number
LABL_PTR_1
Site

Quiet_day_curve [GLORIA]

Quiet day curve values, an array with dimensions equal to number of sites by the maximum number of beams. Not required. Variable properties:
Record variance
VARY
Data type
FLOAT, REAL4, DOUBLE or REAL8

Variable attributes for Absorption:

CATDESC
Quiet day curve
FIELDNAM
QDC ?
UNITS
? Units should be the same as used for Raw_data.
LABLAXIS
QDC
DISPLAY_TYPE
time_series
DEPEND_0
Epoch
DEPEND_1
Site_code
DEPEND_2
Beam_number
LABL_PTR_1
Site_code

Optional GAIA metadata

Beam_azimuth

Beam_zenith

Beam_width

Beam_geographic_latitude

Beam_geographic_longitude

Beam_mapping_height

todo.gif Add comment about riometer image data.

CDF notes

Sample CDF epoch conversions using IDL6.1.1 (Win32):

  IDL> year=[1900,1970,2000] 
  IDL> for indx=0,2 do begin & CDF_EPOCH,epoch,year[indx],1,1,0,0,0,/COMPUTE & PRINT,year[indx],epoch,FORMAT='(I4,2X,F20.2)' & endfor
1900     59958230400000.00
1970     62167219200000.00
2000     63113904000000.00

 
Topic revision: r8 - 2007-05-07 - 21:09:19 - BrianJackel
 
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback