Surface ingesting from the Campbell data logger needs to know the download file to use and its corresponding list of field names, which naturally vary between sites and even between deployments of the same facility.
The first part of the configuration is the site location. The site location is stored with the surface data when they are ingested. In the past this information has been completely ignored, and in fact ISS surface data have been recorded all over the world using the location of Boulder, Colorado. This is your big opportunity to fix this.
Configuring surface ingest: Latitude: 40.0 Longitude: -100.0 Altitude: 1500 Is this correct? (y/n) [y] |
If you choose n, you will be asked to enter each coordinate, with the current coordinate as the default:
Enter site latitude (degrees North): [40.0] Enter site longitude (degrees East, W is negative): [-100.0] Enter site altitude (meters above MSL): [1500] |
The Campbell download file needs to be chosen next. If a setting already exists in the current site configuration, it will be offered as the default first. If no file has been chosen yet, or if you decline to accept the current setting, then the script searches for all files under the directory /iss/configs/campbell with an extension of .dld or .DLD and offers them in a numbered menu:
Choose the Campbell download file: --- --- 0 Search for Campbell files again --- --- 1 atlas/ATLAS99.DLD 2 baotower/baotower.dld 3 cases/iss1/CASES_1.DLD 4 iss1/is1_r002.dld 5 iss2/is2_r001.dld 6 iss3/is3_r001.dld 7 iss3/is3_r002.dld 8 iss4/is4_r002.dld 9 ncu/NCU.DLD 10 p_f_fabl/p_f_fabl.dld Enter file number: |
The very first menu item, 0, repeats the search for Campbell files and redisplays the list of files. For example, if the needed Campbell file had not been added under /iss/configs/campbell yet, it can be added in another terminal window while the configuration script waits for a choice. Choosing option 0 will repeat the file search, and the new file should then appear in the next listing of the file menu. Or, choose any file to continue with the configuration, then return to the surface configuration later after the correct Campbell download file has been put in place. The surface ingest configuration can always be changed by running the surface module manually:
iss2: /iss/etc/init.d/surface config |
Once the needed download file appears in the file menu, select it by entering its number at the menu prompt. This will be the file that the surface ingestor will download to the Campbell data logger to begin ingesting.
For any given Campbell download file, the surface ingestor (cam_ingest program) also needs to know the list of fields to expect from the data logger. This list is dependent on the Campbell program in the download file. Hence the list is stored in a file paired with the download file, in the same directory and with the same name except the extension must be .cif or .CIF (which stands for Campbell ingest fields). The list of fields takes exactly the same form as was originally used in the is.config file.
skip:pres:tdry:rh:wspd:wdir:year:jd:hhmm:secs:skip:vwspd:skip:wdev:skip:skip:esol:netrad:sol:skip:rain:batt:tbox |
If the field file does not already exist, then the configuration will automatically create a field file with the default contents shown above. If this is not correct, then the file must be edited manually, just as in the past for the is.config file. Keep the entire list on one line and with no spaces, separating the field names with semicolons.