Telescopes Data Dictionary

This reference page describes the file formats available in MackSun for POEMAS and SST, including FITS and CSV structures, headers, observation fields and example records.

POEMAS FITS

Format: FITS File | Encoding: Binary | Structure: Header + Observation Data Fields

Header

Field name Data type Description
FILENAME String Name of the generated FITS file
ORIGIN String Institution responsible for data generation
TELESCOP String Name of the telescope used (POEMAS)
INSTRUME String Name of the instrument used (POEMAS)
OBSERVAT String Name of the observatory where the observation took place
STATION String Geographic coordinates and altitude of the station
TZ String Time zone reference
DATE-OBS Date Date of the observation (YYYY-MM-DD)
T_START DateTime Start time of the observation in ISO 8601 format
T_END DateTime End time of the observation in ISO 8601 format
N_RECORD Integer Number of data records in the binary table
FREQUEN String Observed frequency bands (45GHz / 90GHz)

Observation Data Fields

Field name Data type Description
ISO_DATETIME String Timestamp in ISO 8601 format with milliseconds
TBMAX Float Maximum brightness temperature (Kelvin)
TBMIN Float Minimum brightness temperature (Kelvin)
NFREQ Integer Number of observed frequencies
ELE Float Telescope elevation angle (degrees)
AZI Float Telescope azimuth angle (degrees)
TBL45 Float Left polarization brightness temperature at 45 GHz
TBR45 Float Right polarization brightness temperature at 45 GHz
TBL90 Float Left polarization brightness temperature at 90 GHz
TBR90 Float Right polarization brightness temperature at 90 GHz

POEMAS CSV

Delimiter: Pipe (|) | Encoding: UTF-8 | Structure: Header + Observation Data Fields

Header

Field name Data type Description
FILENAME String Name of the generated file
ORIGIN String Institution responsible for data generation
TELESCOP String Name of the telescope used (POEMAS)
INSTRUME String Name of the instrument used (POEMAS)
OBSERVAT String Name of the observatory
STATION String Geographic coordinates and altitude
TZ String Time zone reference
DATE-OBS Date Date of the observation
T_START DateTime Start time of the observation
T_END DateTime End time of the observation
N_RECORD Integer Number of data records
FREQUEN String Observed frequency bands (e.g., 45GHz / 90GHz)

Observation Data Fields

Position Column Name Data type Description
1 ISO_DATETIME String Timestamp in ISO 8601 format with milliseconds
2 TBMAX Float Maximum brightness temperature (Kelvin)
3 TBMIN Float Minimum brightness temperature (Kelvin)
4 NFREQ Integer Number of observed frequencies
5 ELE Float Telescope elevation angle (degrees)
6 AZI Float Telescope azimuth angle (degrees)
7 TBL45 Float Left polarization brightness temperature at 45 GHz
8 TBR45 Float Right polarization brightness temperature at 45 GHz
9 TBL90 Float Left polarization brightness temperature at 90 GHz
10 TBR90 Float Right polarization brightness temperature at 90 GHz

Example

FILENAME|poemas_20250629_1200.csv
ORIGIN|CRAAM/Universidade Presbiteriana Mackenzie
TELESCOP|POlarization Emission of Millimeter Activity at the Sun (POEMAS)
INSTRUME|POlarization Emission of Millimeter Activity at the Sun (POEMAS)
OBSERVAT|CASLEO
STATION|Lat = -31.79852700, Lon = -69.29558300, Height = 2.552 km
TZ|GMT-3
DATE-OBS|2025-06-29
T_START|2025-06-29T12:00:00
T_END|2025-06-29T12:59:59
N_RECORD|3600
FREQUEN|45GHz / 90GHz

ISO_DATETIME|TBMAX|TBMIN|NFREQ|ELE|AZI|TBL45|TBR45|TBL90|TBR90
2025-08-22T09:00:00.000-03:00|305.2|298.7|2|45.0|180.0|302.1|303.3|299.8|300.5
2025-08-22T09:00:01.000-03:00|306.0|299.1|2|45.1|180.2|302.5|303.7|300.0|300.9
2025-08-22T09:00:02.000-03:00|304.8|298.5|2|45.2|180.4|301.9|303.0|299.6|300.2

SST FITS

Header

Field name Data type Description
FILENAME String Name of the generated FITS file
ORIGIN String Institution responsible for data generation
TELESCOP String Name of the telescope used (SST)
INSTRUME String Name of the instrument used (SST)
OBSERVAT String Name of the observatory where the observation took place
STATION String Geographic coordinates and altitude of the station
TZ String Time zone reference
DATE-OBS Date Date of the observation (YYYY-MM-DD)
T_START DateTime Start time of the observation in ISO 8601 format
T_END DateTime End time of the observation in ISO 8601 format
N_RECORD Integer Number of data records in the binary table
DATA_TYP String Type of SST data (e.g., FAST, INTG)
ORIGFILE String Original binary file name
FREQUEN String Frequency bands and channel mapping

Observation Data Fields

Field name Data type Description
ISO_DATETIME String Timestamp in ISO 8601 format with milliseconds
ADCVAL_1 to ADCVAL_6 Integer ADC channel values (uint16)
POS_TIME Integer Position timestamp (int32)
AZIPOS Integer Azimuth position (.001 degrees)
ELEPOS Integer Elevation position (.001 degrees)
PM_DAZ Integer Pointing model correction in azimuth (int16)
PM_DEL Integer Pointing model correction in elevation (int16)
AZIERR Integer Azimuth pointing error (.001 degrees)
ELEERR Integer Elevation pointing error (.001 degrees)
X_OFF Integer Offset in X direction to target center (int16)
Y_OFF Integer Offset in Y direction to target center (int16)
OFF_1 to OFF_6 Integer Attenuator settings (int16)
TARGET Byte Observed target or mirror position (int8)
OPMODE Byte Operation mode (int8)
GPS_STATUS Integer GPS status (int16)
RECNUM Integer Record number (int32)

SST CSV

Delimiter: Pipe (|) | Encoding: UTF-8 | Structure: Header + Observation Data Fields

Header

Field name Data type Description
FILENAMEStringName of the generated file
ORIGINStringInstitution responsible for data generation
TELESCOPStringName of the telescope used (SST)
INSTRUMEStringName of the instrument used (SST)
OBSERVATStringName of the observatory
STATIONStringGeographic coordinates and altitude
TZStringTime zone reference
DATE-OBSDateDate of the observation (YYYY-MM-DD)
T_STARTDateTimeStart time of the observation in ISO 8601 format
T_ENDDateTimeEnd time of the observation in ISO 8601 format
N_RECORDIntegerNumber of data records
DATA_TYPStringType of SST data (e.g., FAST, INTG)
ORIGFILEStringOriginal binary file name
FREQUENStringFrequency bands and channel mapping

Observation Data Fields

Column Name Data type Description
ISO_DATETIMEStringTimestamp in ISO 8601 format with milliseconds
ADCVAL_1 to ADCVAL_6IntegerADC channel values (uint16)
POS_TIMEIntegerPosition timestamp (int32)
AZIPOSIntegerAzimuth position (.001 degrees)
ELEPOSIntegerElevation position (.001 degrees)
PM_DAZIntegerPointing model correction in azimuth (int16)
PM_DELIntegerPointing model correction in elevation (int16)
AZIERRIntegerAzimuth pointing error (.001 degrees)
ELEERRIntegerElevation pointing error (.001 degrees)
X_OFFIntegerOffset in X direction to target center (int16)
Y_OFFIntegerOffset in Y direction to target center (int16)
OFF_1 to OFF_6IntegerAttenuator settings (int16)
TARGETByteObserved target or mirror position (int8)
OPMODEByteOperation mode (int8)
GPS_STATUSIntegerGPS status (int16)
RECNUMIntegerRecord number (int32)

Example

FILENAME|sst_20250629_1200.csv
ORIGIN|CRAAM/Universidade Presbiteriana Mackenzie
TELESCOP|Solar Submillimeter Telescope (SST)
INSTRUME|Solar Submillimeter Telescope (SST)
OBSERVAT|CASLEO
STATION|Lat = -31.79852700, Lon = -69.29558300, Height = 2.552 km
TZ|GMT-3
DATE-OBS|2025-06-29
T_START|2025-06-29T12:00:00
T_END|2025-06-29T12:59:59
N_RECORD|3600
DATA_TYP|FAST
ORIGFILE|sst_raw_20250629_1200.bin
FREQUEN|212GHz / 405GHz

ISO_DATETIME|ADCVAL_1|ADCVAL_2|ADCVAL_3|ADCVAL_4|ADCVAL_5|ADCVAL_6|POS_TIME|AZIPOS|ELEPOS|PM_DAZ|PM_DEL|AZIERR|ELEERR|X_OFF|Y_OFF|OFF_1|OFF_2|OFF_3|OFF_4|OFF_5|OFF_6|TARGET|OPMODE|GPS_STATUS|RECNUM
2025-06-29T12:00:00.000-03:00|1023|980|1001|995|1005|1010|1432567890|123456|654321|5|3|2|1|0|0|10|10|10|10|10|10|1|2|0|1
2025-06-29T12:00:01.000-03:00|1025|982|1003|997|1007|1012|1432567891|123457|654322|5|3|2|1|0|0|10|10|10|10|10|10|1|2|0|2