xenial (1) rundoris.1.gz

Provided by: doris_4.06~beta2+dfsg-3_amd64 bug

NAME

       run - Utility for running the Delft InSAR processor.

SYNOPSIS

       run -s/-e/-v step -ql [-f inputfile -r file-id -d]
       run -g [-M master -S slave -B baseline -R remark  -A author]
       run -h

DESCRIPTION

       This manual page documents briefly the run command.

       This  script  is convenient for running the Doris InSAR software.  It generates template input files, and
       serves as a shell.  It allows you to edit the generated input, and to run Doris.  Of course  the  results
       can also be viewed.
       The  environment  variables  PAGER  and EDITOR are used (if set) for viewing and editing. In your current
       setup, the programs "less" and "vim" are used respectively.  The executable:  "doris"  is  used  (run  -s
       step).

GENERATING OPTIONS

       -g     Generate directories, template input files.
              Use -M -S -A -B -R to specify comments in template input files.
              It makes the following directories:
               for the input files:        "Inputfiles/"
               for the redirected stdout:  "Outinfo/"
               for data output:            "Outdata/"
              Either the program:
               "doris"       (default in your path),
               "doris.debug"  (-d option), or
               "./processor"  (if it exists).
              is called.

       -M master
              Only in combination with -g option.
              Specify name for master image (e.g., orbit number).
              This  variable  is  used  to  name  the output data files and as a comment at the top of the input
              files.
              The M_RESFILE is assigned to 'master'.res
              The I_RESFILE is assigned to 'master_slave'.res

       -S slave
              Only in combination with -g option.
              Specify name for slave image (e.g., orbit number).
              This variable is used to name the output data files and as a comment  at  the  top  of  the  input
              files.
              The S_RESFILE is assigned to 'slave'.res
              The I_RESFILE is assigned to 'master_slave'.res

       -A author
              Only in combination with -g option.
              Specify name of author/ person who is processing.
              Used only as a comment at the top of the input files.

       -B baseline
              Only in combination with -g option.
              Specify baseline (e.g., 100).
              Used only as a comment at the top of the input files.

       -R remarks
              Only in combination with -g option.
              Specify any remarks on the processing.
              Used only as a comment at the top of the input files.

PROCESSING OPTIONS

       -e step
              Edit the inputfiles. then exit (no processing).

       -ql    Quicklook processing. (Edit input: run -e1; run -e2; run -e9).
              If run -s1 has not been done yet, it perform it.
              If run -s2 has not been done yet, it perform it.
              Then it copies the  to master_QL.res and  to slave_QL.res
              Finally it runs doris with options in run -e9 (all steps for interferogram).

       -s step
              Process the input file for this step.
               1: initial steps for master (readfiles, crop, porbits)
               2: initial steps for slave (readfiles, crop, porbits)
               3: coregistration (coarse, fine)
               4: compute coregistration parameters and perform resampling
               5: interferometric product generation and reference phase
               6: phase filtering (and phase unwrapping)
               7: slant to height conversion and geocoding
               8: n/a
               9: quicklook processing.
              The  "quicklook  processing" step first performs a run -s1 and a run -s2 to read master and slave.
              Make sure that you have edited the input files with run -e1 and  run  -e2.   Then,  all  steps  to
              quickly  create  an interferogram are performed.  You can edit that with run -e9, but there should
              be no need for that.

       -v step
              View output file of step.

       -r file-ID
              View/edit result output file.
               1: ""                (master result file)
               2: ""                (slave result file)
               3: ""                (interferogram result file)
               4: "doris.log"       (logfile)

FURTHER OPTIONS

       -f infile
              Specify an input file to process.  Useage of this option is discouraged, use option -s step.   (or
              use command line syntax if you like that better.)

       -d     Use debugger version:   doris.debug
              instead of regular:     doris
              These  executables  have  to  be  in your path.  This option can be used if normal processing goes
              wrong.  The redirected stdout can get very large (2GB) with this option.

       -h     Show summary of options.

EXAMPLES

       Normally, the processing starts by generating input files: run -g
       Then, check/edit the input for the first step: run -e1
       Next the executable doris is called by:        run -s1
       The output can be viewed with:                 run -v1
       for the stdout and with:                       run -r[1/2/3/4]
       The processing continues with the next step:   run -e2 etc.

       To generate the input files for master 21066, slave 01393, with a baseline  of  about  100m  for  testing
       purposes:
         run -g -M 21066 -S 01393 -R "Testing generate option" -B 100

       To edit the input file for step one:
         run -e 1

       To run first step, and put output file (redirected stout) in dir:
         run -s 1

       To view the output file for step one:
         run -v 1

       To run an input file named inputA in the current directory (discouraged with -f):
         run -f inputA
         doris inputA > outputA

SEE ALSO

       doris(1), helpdoris(1), plotoffsets(1), plotcpm(1).
       The DORIS User Manual, available in /usr/share/doc/doris-doc.

KNOWN BUGS

       It is not possible to edit more then one file with the -e option.

AUTHOR

       run is written by Bert Kampes, Delft University, (c)1999-2003, b.m.kampes@lr.tudelft.nl.

       This  manual page was written by Antonio Valentino <antonio.valentino@tiscali.it>, for the Debian project
       (and may be used by others).

                                                November  1, 2010                                         RUN(1)