There are five project files generated by Campbell Scientific data loggers when they are used to collect ShapeArray data. These files contain project information, raw data that will be processed by Measurand's SAACR_raw2data utility, and diagnostic information.


Measurand recommends that all data logger files be saved in the ASCII table data, long header (TOA5) file format defined by Campbell Scientific. The files' names will be prefixed with the project name configured by the SAACR_FileGenerator utility.


Fields within these files are delimited by commas and records are delimited by a carriage return. The top four lines in the file are headers. Actual data records start on line 5 in each file. The following file descriptions assume files are saved in the TOA5 format.


_PROJECT_INFO.dat  


Line 1 has the following fields in order from left to right:

  • The file format type (this should be TOA5)
  • The station name (the friendly name assigned to the logger)
  • The datalogger type (the model)
  • The serial number of the data logger
  • The data logger’s OS version
  • The DLD name (the filename of the data logger program)
  • The DLD signature
  • The table name (this is the name of the table that stores the data in the logger)
 


Line 2 lists the names of the columns from the data logger’s data table. For unmodified programs generated by SAACR_FileGenerator, the columns should be as follows from left to right:

  • TIMESTAMP - The date and time the sample was collected
  • RECORD - A record number starting from zero and incrementing by 1 (possible to have skipped record numbers and record number sequence reset to 0)
  • PROGRAM_VERSION_NUM - The version of the program being run on the logger
  • AVERAGING - The averaging level set for the array. This is the number of sample readings that will be taken and averaged together to produce a single recorded sample value. This is configured in SAACR_FileGenerator when you create the program files. There should be a number of AVERAGING columns equal to the value in the NUMBER_SAAS field.
  • PROJECT_NAME - The name of the project. This is configured in SAACR_FileGenerator when you create the program files.
  • NUMBER_SAAS - The number of ShapeArrays from which data is being recorded. There should be a corresponding number of _SAA#_DATA.dat files
  • NUM_OCTETS_INDEX(#) - For model 1 and 2 ShapeArrays only, lists the number of octets within the ShapeArray. There should be a number of NUM_OCTETS_INDEX columns equal to the value in the NUMBER_SAAS field. The (#) identifies the ShapeArray.
  • NUM_PICS_INDEX(#) - For model 3 ShapeArrays, lists the number of segments within the ShapeArray. There should be a number of NUM_PICS_INDEX columns equal to the value in the NUMBER_SAAS field. The (#) identifies the ShapeArray.
  • SERIAL_NUMS(#, #) - The serial number for each octet or segment. Depending on model, there should be a number of SERIAL_NUMS columns equal to the value in the NUM_OCTETS_INDEX column or NUM_PICS_INDEX column. The (#, #) identify the array and the octet/segment respectively.


Line 3 lists the data types as determined by the logger. Only types for the TIMESTAMP column (TS) and the RECORD (RN) will have values. A blank field will be included for all other columns ("").


Line 4 will begin with blank fields ("") for the TIMESTAMP and RECORD columns followed by an “Smp” header for each other column in the records.


Lines 5+ will be recorded data values. A separate record is created each time the logger program is started.


_SAA#_DATA.dat  


Line 1 has the following fields in order from left to right:

  • The file format type (this should be TOA5)
  • The station name (the friendly name assigned to the logger)
  • The datalogger type (the model)
  • The serial number of the data logger
  • The data logger’s OS version
  • The DLD name (the filename of the data logger program)
  • The DLD signature
  • The table name (this is the name of the table that stores the data in the logger)
 


Line 2 lists the names of the columns from the data logger’s data table. For unmodified programs generated by SAACR_FileGenerator, the columns should be as follows from left to right:

  • TIMESTAMP - The date and time the sample was collected
  • RECORD - A record number starting from zero and incrementing by 1 (possible to have skipped record numbers and record number sequence reset to 0)
  • SERIAL_NUMS - The serial number of the ShapeArray from which the data was sampled. This is a static value that is set by SAACR_FileGenerator. If the serial number doesn’t match the ShapeArray connected to the COM port, only zero data will be recorded for the sample.
  • SAA#_ACC_VALUES(#,#) - Acceleration values measured by the ShapeArray. There will multiple versions of this field with changing # values. The first SAA# is an identifier for the ShapeArray. The (#, #) values represent the sensor or octet identifier and an X, Y, or Z identifier.
    • e.g. for a model 1 or model 2 ShapeArray, the (#, #) will increase in groups of 24 as follows: (1, 1), (1, 2), … , (1, 23), (1, 24), (2, 1), (2, 2), … , (2, 23), (2, 24), …
    • e.g. for a model 3 ShapeArray, (#, #) will increase in groups of 3 as follows: (1, 1), (1, 2), (1, 3), (2, 1), (2, 2), (2, 3), (3, 1), ...
  • SAA#_TEMP_VALUES(#) - Temperature values measured by the ShapeArray. There will multiple versions of this field with changing # values. The first SAA# is an identifier for the ShapeArray. The (#) values represent the sensor identifier for an octet or segment.


Line 3 lists the data types as determined by the logger. Only types for the TIMESTAMP column (TS) and the RECORD (RN) will have values. A blank field will be included for all other columns ("").


Line 4 will begin with blank fields ("") for the TIMESTAMP and RECORD columns followed by an “Smp” header for each other column in the records.


Lines 5+ will be recorded data values. A separate record is created each time the logger records a sample from the ShapeArray.


_LOGGER_DIAGNOSTICS.dat  


Line 1 has the following fields in order from left to right:

  • The file format type (this should be TOA5)
  • The station name (the friendly name assigned to the logger)
  • The datalogger type (the model)
  • The serial number of the data logger
  • The data logger’s OS version
  • The DLD name (the filename of the data logger program)
  • The DLD signature
  • The table name (this is the name of the table that stores the data in the logger)
 


Line 2 lists the names of the columns from the data logger’s data table. For unmodified programs generated by SAACR_FileGenerator, the columns should be as follows from left to right:

  • TIMESTAMP - The date and time the sample was collected
  • RECORD - A record number starting from zero and incrementing by 1 (possible to have skipped record numbers and record number sequence reset to 0)
  • LOGGER_VOLTAGE - The voltage of the data logger in volts (V) as measured at the logger’s power input.
  • LOGGER_TEMPERATURE - The temperature of the data logger in degrees Celsius (degC)
  • NOT_ENOUGH_POWER - A Boolean flag that indicates whether the power supplied to the logger is sufficient for the proper operation of Measurand ShapeArrays. A value of 0 will be recorded for any voltages above 10.5 V. A value of 1 will be recorded when the voltage is 10.5 or lower. When the NOT_ENOUGH_POWER flag is set to 1, only zeroes will be recorded for the readings in the SAA_DIAGNOSTICS.dat and SAA#_DATA.dat files for the corresponding sample.


Line 3 lists the data types as determined by the logger. Only types for the TIMESTAMP column (TS) and the RECORD (RN) will have values. A blank field will be included for all other columns ("").


Line 4 will begin with blank fields ("") for the TIMESTAMP and RECORD columns followed by an “Smp” header for each other column in the records.


Lines 5+ will be recorded data values. A separate record is created each time the logger records a sample from the ShapeArray.


_SAA_DIAGNOSTICS.dat  

Line 1 has the following fields in order from left to right:

  • The file format type (this should be TOA5)
  • The station name (the friendly name assigned to the logger)
  • The datalogger type (the model)
  • The serial number of the data logger
  • The data logger’s OS version
  • The DLD name (the filename of the data logger program)
  • The DLD signature
  • The table name (this is the name of the table that stores the data in the logger)


Line 2 lists the names of the columns from the data logger’s data table. For unmodified programs generated by SAACR_FileGenerator, the columns should be as follows from left to right:

  • TIMESTAMP - The date and time the sample was collected
  • RECORD - A record number starting from zero and incrementing by 1 (possible to have skipped record numbers and record number sequence reset to 0)
  • SERIAL_NUMS(#,#) - The serial numbers of each ShapeArray being monitored. There should be a SERIAL_NUMS column for each SAA being monitored.
  • SAA#_SAATOP_VOLTAGE(#) - The voltage arriving at the cable end of the ShapeArray in volts (V). There should be a SAA#_SAATOP_VOLTAGE column for each SAA being monitored.
  • SAA#_SAATOP_CURRENT(#) - The current being drawn by the ShapeArray in milliamps (mA). There should be a SAA#_SAATOP_CURRENT column for each ShapeArray being monitored.
  • SAA#_SAATOP_TEMPERATURE(#) - The temperature of the ShapeArray top in degrees Celsius (degC). There should be a SAA#_SAATOP_TEMPERATURE column for each SAA being monitored.
 


Line 3 lists the data types as determined by the logger. Only types for the TIMESTAMP column (TS) and the RECORD (RN) will have values. A blank field will be included for all other columns ("").


Line 4 will begin with blank fields ("") for the TIMESTAMP and RECORD columns followed by an “Smp” header for each other column in the records.


Lines 5+ will be recorded data values. A separate record is created each time the logger records a sample from the ShapeArray.


_SERIAL_ERRORS.dat  


Line 1 has the following fields in order from left to right:

  • The file format type (this should be TOA5)
  • The station name (the friendly name assigned to the logger)
  • The datalogger type (the model)
  • The serial number of the data logger
  • The data logger’s OS version
  • The DLD name (the filename of the data logger program)
  • The DLD signature
  • The table name (this is the name of the table that stores the data in the logger)


Line 2 lists the names of the columns from the data logger’s data table. For unmodified programs generated by SAACR_FileGenerator, the columns should be as follows from left to right:

  • TIMESTAMP - The date and time the sample was collected
  • RECORD - A record number starting from zero and incrementing by 1 (possible to have skipped record numbers and record number sequence reset to 0)
  • SERIAL_NUMS(#,#) - The serial numbers of each ShapeArray being monitored. There should be a SERIAL_NUMS column for each ShapeArray being monitored.
  • NUM_CRC_ERRORS(#) - The number of packet errors that occur while a sample is being taken and recorded. There should be a NUM_CRC_ERRORS column for each ShapeArray being monitored. This field is cumulative over the entire time the logger program is running. These counts will be reset when the logger program is restarted.
  • NUM_COM_ERRORS(#) - The number of communication errors while a sample is being taken and recorded. There should be a NUM_COM_ERRORS column for each ShapeArray being monitored. This field is cumulative over the entire time the logger program is running. These counts will be reset when the logger program is restarted.


Line 3 lists the data types as determined by the logger. Only types for the TIMESTAMP column (TS) and the RECORD (RN) will have values. A blank field will be included for all other columns ("").


Line 4 will begin with blank fields ("") for the TIMESTAMP and RECORD columns followed by an “Smp” header for each other column in the records.


Lines 5+ will be recorded data values. A separate record is created each time the logger records a sample from the ShapeArray.