Global Attributes

Required ISTP Complaint Global Attributes (see ISTP Documentation).

• Data_type
• Data_version
• Descriptor
• Discipline
• Instrument_type
  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

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.

BrianJackel: please suggest names for ASCs and MSPs.

Data type

CHAR or UCHAR

Required Variables

ISTP Required Variables

• Epoch (see ISTP documentation).

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

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

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

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