Changeset 141 for CCCC/trunk/README.txt

31/03/14 16:07:37 (7 years ago)

Updated virtual test and correction script generation

1 edited


  • CCCC/trunk/README.txt

    r137 r141  
    2121  --blfmode <mode>      # set mode for batch log file -- see log file modes 
    2222  --flfmode <mode>      # set mode for file-level log file -- see log file modes 
     23  --aMap                # Read in some attribute mappings and run tests with virtual substitutions, see also 
    7172"git clone git://" 
     77The virtual mode can be used to validate substituions before adjusting systems which have been used to generate data, or as the first step of a procedure for repairing some classes of errors. 
     79To use this mode, a mapping file is needed. This can be generated by an initial run of the checker with no virtual substitutions. A file naemd "amapDraft.txt" will be generated. This file should be inspected to ensure that suggested changes make sense. 
     81A typical directive will be of the form: 
     84The meaning is: for variable "rlus", set the attribute "standard_name" to "surface_upwelling_longwave_flux_in_air" where the input file has "surface_upward_longwave_flux_in_air". 
     86If run with the --aMap flag, the checker will test attributes after making virtual substituions. I.e. there are no changes made to the files at this stage, but results of the tests apply as if changes have been made. 
     88After running in virtual mode, will generate a file named "attributeMappingsLog.txt" which contains a record for every change to every file. If the results of running in virtual mode are positive, this file can be used to create a script to modify the files, by running "": 
     90python attributeMappingsLog.txt /tmp/batch1 /tmp/batch1_corrected 
     91## this will generate a list of NCO commands in "", which will apply the changes and create new files in "/tmp/batch1_corrected". 
     93It is recommended that the data values in the corrected files should be checked after running this script. 
     95By default, the program will generate commands to modify the tracking_id and creation_date global attributes at the same time as making other changed. The "history" attribute is modified by the NCO library.  
Note: See TracChangeset for help on using the changeset viewer.