User Software :: CR-Tools :: The CalTable System

• Usage of the CalTables
• Fields of the official LOPES CalTable
• Keywords of the official LOPES CalTable
• (Internal) Structure of the CalTables

The CalTables are a system to store and retrieve calibration and other meta-data.

One piece of data (an atom) can be a string, a double, a dcomplex, an array of double or an array of dcomplex. Each atom is identified by its field name (which defines its type), the antenna ID, and the date for which it is valid.

A reading operation can look like this:

  String tablename="lopes/calibration-data/CalTable/LOPES_CalTable";
  CalTableReader table;
  // open the table
  table.AttachTable(tablename);
  // define which value we are interested in
  String fieldName="AntennaPosition";
  Int AntennaID = 010101; //antenna 1 in LOPES notation
  uInt date = time(); //get the value that is valid today
  // get the data
  Vector<Double> Pos;
  if (!table.get(date, AntennaID, fieldName, &Pos)) {
    cerr << "Error while retrieving data" << endl;
  };
  cout << "The " << fieldName << " of antenna " << AntennaID <<
       " for the time label " << date << " is: " << Pos << endl;

Notes:

• In the table.get() call you have to supply the correct type for the field you are requesting. E.g. if the field whose fieldName you asked for is of the type string, then the variable in which the data is to be stored also has to be of the type string. Otherwise the call returns false.
• In the table.get() call, if the fieldName of AntennaID does not exist the call returns false.
• In the table.get() call, if no valid data for the requested time is found the call returns false.

Writing to the CalTable is only slightly more complicated, but still should only be done by trained personel.

Adding fields to a CalTable should only be done by experts, as the later performance can be improved by taking advantage of the internal structure of the CalTables.

This is the list of fields in the official LOPES CalTable.

The definition of the fields is also in the description of the column in the master table.

This is the list of keywords in the LOPES CalTable, that can be read with GetKeyword():

This is still missing. (And probably will for some time. Nagg me if you need it. Andreas H.)

← User Software • CR-Tools