CRfit Utilities Reference

CRfit is the somewhat outdated name of the library of Matlab routines created for analysis of data from the Anderson Group's ICOS Instrument. The 'CR' stands for 'Cavity Ringdown,' which was originally the focus of that instrument's development, and the name stuck. Many of these routines have since found much wider utility in analyzing data from newer instruments which use neither ringdown nor ICOS techniques. The main thing these measurements have in common is a file format for storing scan-oriented data from high-speed sensors.

Availability

The CRfit library is available via anonymous CVS from the ABCD Forge server.

Directory Hierarchy

The library expects the following directory hierarchy:

Experiment Root Directory

The experiment root directory contains all of the run directories. It may also contain various configuration files that remain relatively constant from run to run.

Run Directories

The run directories are usually named with the YYMMDD.R format identifying the date of the run. Some plotting utilities will recognize a trailing 'F' in the directory name to indicate flight data. This is the directory you will be in when you invoke most of the CRfit functions. It contains the CPCI14 directory and all the data and configuration files specific to this run.

CPCI14 Directory

The CPCI14 directory is the root of a hierarchical directory structure containing the raw data from the experiment. This directory derives its name from the data acquisition board in use when the library was created. Since then the library has been used with newer boards. Although some functions will allow you to specify a different name for this directory, the name is hard-coded in other locations. Ideally, this name could be set in a configuration file, but for now, we just live with it.

Minimum Requirements

PT.mat contains the following variables:

TPT
Unix Time (seconds since 1970)
CellP
Cell Pressure in Torr
Tavg
Average Cell Temperature in Kelvin
QCLI_Wave
Scan Waveform index
CPCI14
Scan file index

CellP and Tavg need to be present, but their values are only significant in the later stages of data analysis, so placeholders or approximations can be used early on.

QCLI_Wave refers to the waveform and sampling definitions defined in waves.m. The general assumption is that data that is sampled differently probably needs to be analyzed differently, and many of the functions will enforce this requirement.

CPCI14 is the index number of the current data file under the CPCI14 hierarchy. The indexing mechanism is described under Multi-level File Routines, and there are analogous Matlab routines mlf_path and mlf_mkdir in the CRfit library. It is not necessary for every CPCI14 file to have a corresponding entry in PT.mat. If the CPCI14 number skips, corresponding values for time, pressure and temperature are interpolated from the neighboring values.


Return to Manuals Guide


last updated: Thu Nov 13 13:53:32 2008 webmaster@huarp.harvard.edu
Copyright 2008 by the President and Fellows of Harvard College