
     Usage and simple explanation of NuSDaS utility 

1. grib2nus

 usage: grib2nus (-v) (-NUSDASxx) grib-filename ...
        -v : verbose mode
        -NUSDASxx : if not specified, NUSDAS01 is used for output NuSDaS.
                    xx must be 01-49.
 explanation: 
        The grib2nus utility converts grib files to NuSDaS dataset.
        A NuSDaS definition file may be made on some assumption.

2. nus2grib

 usage: nus2grib target (output) (-B) (-T,-Ccctfile) (-v,-V) (-F) (-E) (-M)

        target: NuSDaS parameter table for each GRIB
        output: priority 1 = specified as the argument
                         2 = specified in the targetfile
                         3 = "defaults.grib"
                    if stdout is specified as outputfile,
                    output binary data to stdout. Be Caution!
        -v : verbose mode (output to stdout)
        -V : verbose mode (output to stderr)
        -B : Add a BCH and bulletin header. Specify outputfile
             and set TTAAii RJTD in the targetfile
        -T : remake grid from LatLon to Thinned Grid
        -C : Convert grid coordinate from orignal to specified
             in cctfile by simple interpolation. Now, only
             Lambert to LatLon conversion is supportted!
        -F : calculate data from another data
             ( Ex. RH from T & TTd )
        -E : if any error occured, then exit nus2grib!!
             ( Default is the case of only fatal error)
        -M : add the third section(bitmap section)

 files: TIMECARD: Basetime is specified as following, "yyyy mm dd hh mm".

 explanation:
        The nus2grib utility converts NuSDaS dataset to grib format files
        following the target file. Sample target file is in the directory
        nustool/Sample.

3. nus_reform

 usage: nus_reform

 files: TIMECARD: Basetime is specified as following, "yyyy mm dd hh mm".
        TF_TABLE: The list of changing items.

 explanation:
        The nus_reform utility changes the name of NuSDaS key word items
        by the TF_TABLE file such as following. 

#TYPE111 TYP2 TYP3 MEMB PLANE1 ELMENT TYPE1111 TYP2 TYP3 MEMB PLANE1 ELMENT
_WFMLLPP FCSV GRB1 mean SURF   PSEA   _WFMLLPP FCSV N2GB      SURF   EAvSLP

        Above case, the name of type3, member and element are changed.

4. nuscmp

 usage: nuscmp file1 file2 (-v,-V) (-c) (-s) (-n)
        If -v or -V is specified, difference of create time is ignored.
        In case of -V, the comparison is continued to the end of file
         except for the fatal difference. Also record detail information
         are printted out.
        If -n is specified, difference of NuSDaS NUSD record is ignored.
        If -c is specified, difference of NuSDaS CNTL record is ignored.
        If -s is specified, difference of NuSDaS SUBC record is ignored.

 explanation:
        The nuscmp utility compares a file1 and a file2.
        same file case -> return 0, and different file case -> return 1

5. nusdas_add_time

 usage: nusdas_add_time taget_file add_time
         target_file: A NuSDaS file you want to change basetime and 
                      validtime.
         add_time: Minutes of adding to basetime and validtime.

 explanation:
        The nusdas_add_time utility makes a new NuSDaS file which is 
        same as the original NuSDaS file except for the basetime and
        validtime. A new NuSDaS file name is added the suffix ".+(-)mmm"
        which is the time adding to the basetime and validtime.

6. nusdas_check_def

 usage: nusdas_check_def define_file
         defile_file: A NuSDaS definition file you want to check.

 explanation:
        The nusdas_check_def utility checks the format and the necessary
        item of specified NuSDaS definition file.

8. nusdas_dump_rec

 usage: nusdas_dump_rec target_file (-l)
         target_file: A NuSDaS file you want to see head information of
                     each records.
         -l: Long format. If the record is packed as a n-byte pack,
             the base value and the amplitude value are printted.

 explanation:
        The nusdas_dump_rec utility prints head informatino of each records
        in the NuSDaS file.

9. nusdas_dump_indx

 usage: nusdas_dump_indx nrd def_file year mon day hour min
         nrd: NuSDaS root directory
         def_file: NuSDaS definition file
         year, mon, day, hour, min: Basetime when you want to delete files.

 explanation:
        The nusdas_dump_indx utility indicates the information that each 
        DATA record is already recorded or yet. The mean of character marks
        are following,
          O: already recorded.
          -: not recorded.
          x: not defined.
          .: The recordable file is not created yet.

10. nusdas_file_del

 usage: nusdas_file_del nrd def_file year mon day hour min
         nrd: NuSDaS root directory
         def_file: NuSDaS definition file
         year, mon, day, hour, min: Basetime when you want to delete files.

 explanation:
        The nusdas_file_del utility deletes files which belong to the
        specified nrd, def_file and date.

11. nusdas_vfsys_dsp

 usage: nusdas_vfsys_dsp nrd def_file
         nrd: NuSDaS root directory
         def_file: NuSDaS definition file

 explanation:
        The nusdas_vfsys_dsp utility indicates the tree structure of
        the NuSDaS dataset. The basetime is tentatively 00UTC 1 Mar.
        2001.

12. nusdup

 usage: nusdup (RECONST) (IN_BASE)
         RECONST: specify in case of the change of path rule.
         IN_BASE: nusdup ardinary duplicate dataset based on the definition
                  file for output. This key word may be specified in case of
                  basing on the definition file for input.

 files: NUSDEF_IN: NuSDaS definition file for the original dataset.
        NUSDEF_OUT: NuSDaS definition file for the duplication dataset.
        NUSDAS01: NuSDaS root directory for the original dataset.
        NUSDAS99: NuSDaS root directory for the duplication dataset.
        TIMECARD: Basetime is specified as following, "yyyy mm dd hh mm".

 explanation:
        The nusdup utility duplicates NuSDaS dataset. If RECONST is specified,
        it changes the path and re-disposes data record to each file.

