audit [ parameter=value ... ] [ inputfile ... ]
Parameters are: script_output, include_master, printout.
audit reports the history (or `audit trail') of one or more TeraScan datasets. The history of a given dataset consists of the names and parameters of each function used to produce the dataset plus the history of all input datasets. This is in contrast to session, which produces a chronological report of all TeraScan processing.
There are two choices for output report format: indented tree or C-shell script. C-shell scripts attempt to be chronological. Indented trees show processing order by identation. The two output formats will be shown in more detail in the examples below.
In the following example, two datasets were created by ingesting raw AVHRR data using avin, calibrating that data using avcal, and registering that data to a common grid using fastreg. Then these two datasets were composited using composite to create a third dataset comp.
The session history of comp is listed first, following by the indented tree and C-shell script versions of audit. Note that neither of the two audit output formats reflect the true chronology of the original processing.
Note also that because include_master=no, the creation of the master does not appear in the C-shell script output.
% ########################################################################## % session Tue Nov 29 12:57:56 1994 Page 1 12219 12:57:56 avin . 12219 12:57:56 on_pass_disk : char( 3) ? [yes] 12219 12:57:58 pass_number : int ( 8) ? [2] 7 8 12219 12:58:03 use_master : char( 3) ? [yes] 12219 12:58:04 master_file : char(255) ? [Master] 12219 12:58:05 delta_line : int ? [1] 12219 12:58:06 delta_sample : int ? [1] 12219 12:58:06 channels : int ( 5) ? [1 2 3 4 5] 4 12219 12:58:08 raw pass disk: Processing pass 7 12219 12:58:10 ./n10.94333.1457 starts at time 14:57:42.727, sample 1541. 12219 12:58:17 Actual size is 679 lines by 490 samples. 12219 12:58:17 raw pass disk: Processing pass 8 12219 12:58:19 ./n12.94333.1556 starts at time 15:56:51.646, sample 982. 12219 12:58:27 Actual size is 651 lines by 849 samples. 12220 12:58:32 avcal n10.94333.1457 n12.94333.1556 12220 12:58:32 temp_units : char( 10) ? [celsius] 12220 12:58:32 full_report : char( 3) ? [no] 12221 12:58:53 fastreg n10.94333.1457 n12.94333.1556 reg 12221 12:58:53 master_file : char(255) ? [Master] 12221 12:58:54 include_vars : char(255) ? [] 12221 12:58:55 poly_size : real ? [100] 12221 12:58:56 reg/n10.94333.1457: avhrr_ch4: [ 1, 512] X [ 1, 640] 12221 12:59:00 reg/n12.94333.1556: avhrr_ch4: [ 1, 512] X [ 1, 640] 12222 12:59:17 composite reg/n10.94333.1457 reg/n12.94333.1556 comp 12222 12:59:17 include_vars : char(255) ? [] 12222 12:59:24 method : char( 6) ? [mean] % ########################################################################## % audit comp script_output : char( 3) ? [no] printout : char( 3) ? [no] comp History Page 1 composite include_vars= method=mean min_good_vals=1 reg/n10.94333.1457 fastreg master_file=Master include_vars= poly_size=100 max_memory=4 n10.94333.1457 avcal radiance_only=no temp_units=celsius full_report=no vis_coefs=0 0 0 0 line_interval=100 solar_corr=no avin on_pass_disk=yes pass_number=7 8 use_master=yes master_file=Master delta_line=1 delta_sample=1 channels=4 max_time_adj=0 bogus_lines=0 hrpt_format=auto Master master projection=rect center_lat=34n center_lon=120w num_lines=512 num_samples=640 pixel_width=1.1132 pixel_height=1.1132 rotate_angle=0 reg/n12.94333.1556 fastreg master_file=Master include_vars= poly_size=100 max_memory=4 n12.94333.1556 avcal radiance_only=no temp_units=celsius full_report=no vis_coefs=0 0 0 0 line_interval=100 solar_corr=no avin on_pass_disk=yes pass_number=7 8 use_master=yes master_file=Master delta_line=1 delta_sample=1 channels=4 max_time_adj=0 bogus_lines=0 hrpt_format=auto Master master projection=rect center_lat=34n center_lon=120w num_lines=512 num_samples=640 pixel_width=1.1132 pixel_height=1.1132 rotate_angle=0 % ########################################################################## % audit comp script_output : char( 3) ? [no] yes include_master : char( 3) ? [no] printout : char( 3) ? [no] #! /bin/csh avin \\ on_pass_disk='yes' \\ pass_number='7 8' \\ use_master='yes' \\ master_file='Master' \\ delta_line='1' \\ delta_sample='1' \\ channels='4' \\ max_time_adj='0' \\ bogus_lines='0' \\ hrpt_format='auto' \\ n12.94333.1556 if ($status != 0) exit $status avcal \\ radiance_only='no' \\ temp_units='celsius' \\ full_report='no' \\ vis_coefs='0 0 0 0' \\ line_interval='100' \\ solar_corr='no' \\ n12.94333.1556 if ($status != 0) exit $status fastreg \\ master_file='Master' \\ include_vars= \\ poly_size='100' \\ max_memory='4' \\ n12.94333.1556 \\ reg/n12.94333.1556 if ($status != 0) exit $status avin \\ on_pass_disk='yes' \\ pass_number='7 8' \\ use_master='yes' \\ master_file='Master' \\ delta_line='1' \\ delta_sample='1' \\ channels='4' \\ max_time_adj='0' \\ bogus_lines='0' \\ hrpt_format='auto' \\ n10.94333.1457 if ($status != 0) exit $status avcal \\ radiance_only='no' \\ temp_units='celsius' \\ full_report='no' \\ vis_coefs='0 0 0 0' \\ line_interval='100' \\ solar_corr='no' \\ n10.94333.1457 if ($status != 0) exit $status fastreg \\ master_file='Master' \\ include_vars= \\ poly_size='100' \\ max_memory='4' \\ n10.94333.1457 \\ reg/n10.94333.1457 if ($status != 0) exit $status composite \\ include_vars= \\ method='mean' \\ min_good_vals='1' \\ reg/n12.94333.1556 \\ reg/n10.94333.1457 \\ comp if ($status != 0) exit $status
C-shell script output is intended to be redirected to disk file so it can be edited and turned into a re-usable data-processing script. This is most appropriate for product generation from a single input source, e.g., a single pass of raw satellite telemetry.