copyxfm [ parameter=value ... ] [ inputfile ... ]
Parameter is master_file.
The function copyxfm copies the earth transform attributes from a master file to any number of datasets. The master file may be a file generated by the function master, or a dataset with earth transform attributes.
The input file is the file to which the earth transform attributes will be copied.
The name of the file from which to copy earth transform attributes. This can be a master file or a registered dataset.
Valid responses are any file with earth transform data. The default is Master.
This process is done when you would like to do custom data manipulation. It is always a good idea to get a contents printout of the original dataset. With such a printout your are able to compare contents at the end of this process.
Contents of File: n11.93207.2143 Page 1
Dimension Size Coord Scale Offset
line 709 y 1 0
sample 971 x 1 0
dim_2 103 ? 1 0
Attribute Type Units Value
channels long 5
projection long std_projection rectangular
et_affine double -0.5 0 0 0.333333 250.5 250.5
satellite string12 noaa-11
sensor long std_sensor avhrr
pass_date long std_date 93/07/26
start_time double std_time 21:39:52.32
time_adjust double std_time 00:00:00
attitude double radians 0 0 0
sensor_tilt double radians 0
scan_samples long 2048
scan_rates double 6 40000 37.6991
sensorient double radians 0 0.785398 0 0.965167
-0.965167
orb_elem_date long std_date 93/06/02
orb_elements double 0.462276 0.828981 0 0.0011983
0.332906 0.661182 0.275354
center_lat double std_latitude 43 12.60 N
center_lon double std_longitude 84 1.80 W
map_angle double radians 0
proj_param double std_latitude 0 0.00 N
history byte
Variable Type Units
hrpt_header short
avhrr_ch5 short raw_counts
Variable Dimension Size
hrpt_header line 709
hrpt_header dim_2 103
avhrr_ch5 line 709
avhrr_ch5 sample 971
Variable BadValue ValidMin ValidMax Scale Offset
hrpt_header -32768 -32768 32767 1 0
avhrr_ch5 -1 -32768 32767 1 0
Now you are ready to export the TeraScan dataset into binary format. The hrpt header and avhrr channels are not exported at the same time because they have different dimensions.
% expbin n11.93207.2143 in/out files : char(255) ? n11.93207.2143 2143.exp include_vars : char(255) ? [] avhrr_ch5 sort_by_var : char( 3) ? [yes] no apply_scaling : char( 3) ? [no] %
After the TeraScan dataset has been exported successfully, perform the customization of the data. When all customizing is finished import the dataset back into a TeraScan dataset. (Keep in mind, you will not be able to run contents on the exported file because it is no longer in tdf format.)
% impbin in/out files : char(255) ? 2143.exp 2143xfm.tdf dim_sizes : int ( 3) ? 709 971 dim_names : char( 63) ? [line sample] var_names : char(255) ? avhrr_ch5 var_units : char( 31) ? [- ] var_types : char( 15) ? short var_badvals : real ? [0] sort_by_var : char( 3) ? [yes] no header_size : int ? [0] record_size : int ? [1942] rel_offsets : int ? [0] instantiate : char( 3) ? [no] yes %
This is the contents of the customized data without the earth transform data.
lapaz% contents 2143xfm.tdf printout : char( 3) ? [no] Contents of File: 2143xfm.tdf Page 1 Dimension Size Coord Scale Offset line 709 y 1 0 sample 971 x 1 0 Attribute Type Units Value history byte Variable Type Units avhrr_ch5 short - Variable Dimension Size avhrr_ch5 line 709 avhrr_ch5 sample 971 Variable BadValue ValidMin ValidMax Scale Offset avhrr_ch5 0 -32768 32767 1 0
To complete this task the earth transform needs to be copied from the original dataset to the customized version of the dataset. The input file is the file in which you will be copying the earth transform data to, and the Master file is the original dataset which you first exported from.
lapaz% copyxfm input file(s) : char(255) ? 2143xfm.tdf master_file : char(255) ? [Master] n11.93207.2143 %
The following is the contents of the customized dataset that the earth transform was copied to in the above example. You notice some variable do not appear in this contents, that is because some of the variable information in not transferable. This information has been lost during the export phase.
Contents of File: 2143xfm.tdf Page 1 Dimension Size Coord Scale Offset line 709 y 1 0 sample 971 x 1 0 Attribute Type Units Value projection long std_projection rectangular et_affine double -0.5 0 0 0.333333 250.5 250.5 center_lat double std_latitude 43 12.60 N center_lon double std_longitude 84 1.80 W map_angle double radians 0 proj_param double std_latitude 0 0.00 N history byte Variable Type Units avhrr_ch5 short - Variable Dimension Size avhrr_ch5 line 709 avhrr_ch5 sample 971 Variable BadValue ValidMin ValidMax Scale Offset avhrr_ch5 0 -32768 32767 1 0 %
expbin, impbin, master, datasets
The above examples apply when you would like to do custom manipulation of a TeraScan dataset. Expbin and impbin must always accompany the copyxfm function.
Last Update: $Date: 1999/05/10 20:13:16 $