Debian Codegraph @

bin/helpdoris

raw ◀ ▶
1 Debian patch touch this file
•1 #!/bin/bash
2 ##!/bin/ksh
3 # processor.helpfile
4 # simulate man like help for processor options
5 #
6 # History
7 # 03/03/99 Initial version - [BK] Bert Kampes
8 # 19/03/99 Added troff and printout
9 # 03/11/00 Changed to /usr/bin/ksh for Linux default (?)
10 # 07/02/02 Changed to /usr/sh for Cygwin
11 # 15/10/11 less escape code fix [MA]
12 # 15/10/11 Fixed some old comments [MA]
13 #
14 ## RCS at end of file #####
15 #######################
16 # expand tabs before formatting.
17 # . .IP " " -2
18
19 # .TH "$bn " "1" "$line"
20 # .ds )H $sswname
21 # .ds ]W Release 0.0: March 1999
22
23 # select printer, default geodesy 4th floor
24 if [ "X$PRINTER" != "X" ]; then
25 THEPRINTER="$PRINTER"
26 elif [ "X$LPDEST" != "X" ]; then
27 THEPRINTER="$LPDEST"
28 else
29 THEPRINTER="d5simx4de"
30 fi
31
32 VERSION="3.6++"
33 bn=`basename $0` # name of this file
34 swname="Doris (Delft Object-oriented Radar Interferometric Software) - TU Delft"
35 sswname="Doris" # short software name
36 ##################################################################################
37 BERTLINE()
38 {
39 echo " +---------------+-----------------------------------------------+---------- "
40 }
41
42 BERTLINES()
43 {
44 echo .RE 1
45 echo
46 echo
47 echo $line
48 echo " keyword #arg default (man/opt)"
49 echo $line
50 }
51 line=`BERTLINE` # function to print line
52 lines=`BERTLINES` # function to print lines
53
54
55 ##################################################################################
56 MANPG() {
57 cat << MANEOF
58
59 .DA
60
61 "$bn" \- find out options for processor software; print it out. Version: $VERSION - TUDelft
62
63 Usage:
64 .RS 3
65 .B
66 $bn
67 [
68 .ul
69 word
70 /
71 .B
72 -p
73 ]
74 .br
75 .B
76 processor -h
77 .ul
78 [word]
79
80
81 .RS 3.2
82 .ul
83 word
84 start $bn with searching for
85 .ul
86 word.
87 .br
88 .B
89 -p
90 print this helpfile to printer: $THEPRINTER.
91
92
93 .RS 3
94 press
95 .B
96 h
97 for help on pager (search, mark, forward, backwards, etc.)
98
99
100
101 $lines
102 .ul
103 General cards
104
105 .TP 4
106 .B
107 c 0 opt
108 .B
109 .br
110 .B
111 C
112 .br
113 .B
114 comment
115 .br
116 .B
117 COMMENT
118 .br
119 .B
120 #
121 .br
122 .B
123 //
124 .br
125 Any text after these keys is ignored.
126
127
128 .TP 4
129 .B
130 BEEP 1 WARNING \\
131 Controls level of beeping. Options are:
132 .br
133 .ul
134 ERROR
135 only beeps on error.
136 .br
137 .ul
138 WARNING
139 beeps on errors and warnings.
140 .br
141 .ul
142 PROGRESS
143 beeps on errors, warnings and progress.
144 .br
145 .ul
146 ON
147 Enables beeping, level is highest (PROGRESS).
148 .br
149 .ul
150 OFF
151 disables beeping.
152
153 .TP 4
154 .B
155 PREVIEW 1 OFF \\
156 Controls generation of SUNraster preview files (uses cpxfiddle system call).
157 .br
158 .ul
159 ON
160 Enables preview generation. SUNraster files are created after most steps where it is
161 appropriate. This is done by writing a small shell script in the current directory,
162 which then is executed. This script can later be executed by the user again.
163 .br
164 .ul
165 XV
166 Same as ON, but additionally calls the program xv to view the results.
167 .br
168 .ul
169 OFF
170 disables preview generation.
171
172 .TP 4
173 .B
174 SCREEN 1 debug \\
175 Controls level of output to standard out.
176 .br
177 .ul
178 ERROR
179 only error are written to stout.
180 .br
181 .ul
182 WARNING
183 errors and warnings.
184 .br
185 .ul
186 PROGRESS
187 errors, warnings and progress.
188 .br
189 .ul
190 INFO
191 errors, warnings, progress and info.
192 .br
193 .ul
194 DEBUG
195 errors, warnings, progress, info, debug.
196 .br
197 .ul
198 TRACE
199 errors, warnings, progress, info, debug, trace.
200 tracing shows all visited functions.
201 If you compile a debug version of doris, a lot more is traced,
202 also in the matrix class.
203
204
205
206 .TP 4
207 .B
208 BATCH 0 or 1 off \\
209 Specifies non-interactive processing.
210 .br
211 If
212 .ul
213 ONLYPROCESS
214 mode then always in batch.
215 .br
216 If (only 1)
217 .ul
218 PROCESS
219 card then this card is signifiant.
220 .br
221 .ul
222 ON
223 do non-interactive processing, except when problems are signalled.
224 .br
225 .ul
226 OFF
227 do interactive processing.
228
229
230 .TP 4
231 .B
232 LISTINPUT 0 or 1 on \\
233 copying inputoptionsfile to logfile.
234 .br
235 .ul
236 ON
237 do copy the input file to the logfile.
238 .br
239 .ul
240 OFF
241 do not copy the input file to the logfile.
242
243
244 .TP 4
245 .B
246 OVERWRITE 0 or 1 off \\
247 Overwrite existing data output files if they exist.
248 .br
249 .ul
250 ON
251 overwrite.
252 .br
253 .ul
254 OFF
255 do not overwrite.
256
257
258 .TP 4
259 .B
260 ELLIPSOID 1 or 2 wgs84
261 Change ellipsoid.
262 NOT OK in version $VERSION
263 .br
264 .ul
265 WGS84
266 use wgs84.
267 .br
268 .ul
269 GRS80
270 use grs80.
271 .br
272 .ul
273 BESSEL
274 use bessel.
275 .br
276 .ul
277 a b
278 use specified semi major/minor.
279
280
281 .TP 4
282 .B
283 MEMORY 1 250 \\
284 Specify available memory (integer MB).
285
286
287 .TP 4
288 .B
289 ORB_INTERP 2 POLYFIT deg \\
290 Interpolation method for orbits. Default polynomial fit of
291 maximum degree (interpolation). If there are more than 6
292 datapoints the degree is 5 by default. Optionally with
293 the second argument the degree can be given. Alternatively
294 SPLINE can be used (natural cubic splines).
295
296
297 .TP 4
298 .B
299 DUMPBASELINE 2 0 0 \\
300 Dump the baseline parameters as INFO variables to stdout
301 evaluated on a grid of x lines and y pixels
302 (dimensions of current master).
303 Also write a 2d model of degree 1 to stdout for perpendicular baseline.
304 This is only done if the precise orbits are available.
305
306
307 .TP 4
308 .B
309 LOGFILE 1 log.out \\
310 Name of log output file.
311
312
313 .TP 4
314 .B
315 M_RESFILE 1 master_result.out \\
316 Name of result master output file.
317
318
319 .TP 4
320 .B
321 S_RESFILE 1 slave_result.out \\
322 Name of result slave output file.
323
324
325 .TP 4
326 .B
327 I_RESFILE 1 interferogram.out \\
328 Name of result interferogram output file.
329
330
331 .TP 4
332 .B
333 ONLYPROCESS 1 opt/man \\
334 Only process a specified step.
335 .br
336 A ONLYPROCESS or PROCESS card is mandatory.
337
338 .ul
339 M_READFILES
340 Read parameters from volume, leader, data file (null file) for Master.
341 .br
342 .ul
343 S_READFILES
344 Read parameters from volume, leader and data file (null) for Slave
345 .br
346 .ul
347 M_CROP
348 Read in slc data file, write data to pixel interleaved internal format (raster).
349 .br
350 .ul
351 S_CROP
352 Read in slc data file, write data to pixel interleaved internal format (raster).
353 .br
354 .ul
355 M_PORBITS
356 Compute precise orbits with getorb for Master.
357 .br
358 .ul
359 S_PORBITS
360 Compute precise orbits with getorb for Slave.
361 .br
362 .ul
363 M_FILTAZI
364 Filter master image in azimuth direction.
365 .br
366 .ul
367 S_FILTAZI
368 Filter slave image in azimuth direction.
369 .br
370 .ul
371 COARSEORB
372 Coarse coregistration based on precise orbits.
373 .br
374 .ul
375 COARSECORR
376 Coarse coregistration based on correlation.
377 .br
378 .ul
379 FINE
380 Fine coregistration.
381 .br
382 .ul
383 COREGPM
384 Compute coregistration parameters.
385 .br
386 .ul
387 RESAMPLE
388 Interpolate slave image to master grid.
389 .br
390 .ul
391 FILTRANGE
392 Adaptive range filter master/slave (after resampling).
393 .br
394 .ul
395 INTERFERO
396 Compute complex interferogram;
397 Subtract reference phase here or later.
398 Optionally use oversampling.
399 .br
400 .ul
401 COMPREFPHA
402 Compute reference interferogram of mathematic body (ellipsoid),
403 model this with a 2d polynoial.
404 .br
405 .ul
406 COHERENCE
407 Compute complex coherence image.
408 Subtract reference phase here or later.
409 Possible use complex interferogram.
410 .br
411 .ul
412 SUBTRREFPHA
413 Subtract reference phase computed in step COMPREFPHA
414 from complex intereferogram.
415 .br
416 .ul
417 COMPREFDEM
418 Compute reference interferogram of DEM.
419 for now gtopo30 only.
420 .br
421 .ul
422 SUBTRREFDEM
423 Subtract reference interferogram of DEM (step COMPREFDEM)
424 from complex interferogram.
425 .br
426 .ul
427 FILTPHASE
428 Filter interferogram.
429 .br
430 .ul
431 UNWRAP
432 Unwrap interferogram .
433 For now use external routines, e.g., Ghiglia/Pritt , Snaphu
434 .br
435 .ul
436 DINSAR
437 Differential interferometry (3 or 4 pass).
438 .br
439 .ul
440 SLANT2H
441 Convert to height system.
442 .br
443 .ul
444 GEOCODE
445 Put in xyz system.
446
447
448 .TP 4
449 .B
450 PROCESS 1 opt/man \\
451 Process the specified step, see ONLYPROCESS.
452 .br
453 (more than one PROCESS card may be specified).
454 .br.
455 (cards are overwritten by ONLYPROCESS).
456
457
458 .TP 4
459 .B
460 STOP 0 man \\
461 End interpretation inputoptionsfile.
462
463
464 $lines
465 .ul
466 step reading files
467 Mandatory for *_READFILES
468
469 .TP 4
470 .B
471 M_IN_METHOD 1 ERS \\
472 identifyer what is to be read ASAR, Radarsat 1/2, ERS1/2, Envisat ASAR,
473 JERS, ALOS, Terrasar-X and Cosmoskymed.
474 JERS and ALOS uses ERS programs.
475
476 .TP 4
477 .B
478 M_IN_VOL 1 man \\
479 Filename of volumefile master (not used for ASAR).
480
481 .TP 4
482 .B
483 M_IN_LEA 1 man \\
484 Filename of leaderfile master (not used for ASAR).
485
486 .TP 4
487 .B
488 M_IN_NULL 1 man \\
489 Filename of nullfile master (not used for ASAR).
490 .br
491 (may be dummy name, not actually used).
492
493 .TP 4
494 .B
495 M_IN_DAT 1 man \\
496 Filename of datafile master.
497
498
499 .TP 4
500 .B
501 S_IN_VOL 1 \\
502 see
503 .ul
504 M_IN_VOL
505
506 .TP 4
507 .B
508 S_IN_LEA 1 \\
509 see
510 .ul
511 M_IN_LEA
512
513 .TP 4
514 .B
515 S_IN_NULL 1 \\
516 see
517 .ul
518 M_IN_NULL
519
520 .TP 4
521 .B
522 S_IN_DAT 1 \\
523 see
524 .ul
525 M_IN_DAT
526
527
528
529 $lines
530 .ul 1
531 step conversion SLC format to internal format on disk
532 Mandatory for *_CROP
533
534 .TP 4
535 .B
536 M_CROP_ID 1 step01 \\
537 Identification of this step.
538 This card does nothing.
539
540
541 .TP 4
542 .B
543 M_CROP_IN 1 man \\
544 Filename of input data in slc format.
545
546
547 .TP 4
548 .B
549 M_CROP_OUT 1 man \\
550 Filename of output in raw format.
551
552
553 .TP 4
554 .B
555 M_DBOW 4 total image
556 (Master database output window)
557 .br
558 min line, max line, min pix, max pix.
559 .br
560 line=1: first line.
561
562
563 .TP 4
564 .B
565 S_CROP_ID 1
566 see
567 .ul 1
568 M_CROP_ID
569
570 .TP 4
571 .B
572 S_CROP_IN 1
573 see
574 .ul 1
575 M_CROP_IN
576
577
578 .TP 4
579 .B
580 S_CROP_OUT 1
581 see
582 .ul 1
583 M_CROP_OUT
584
585
586 .TP 4
587 .B
588 S_DBOW 4
589 see
590 .ul 1
591 M_DBOW
592
593
594
595 $lines
596 .ul
597 step Precise Orbits (Uses getorb DEOS).
598 Mandatory for proces *_PORBITS
599
600 .TP 4
601 .B
602 M_ORBDIR 1 man \\
603 Name of directory for ODR precise orbit files (getorb).
604
605 .TP 4
606 .B
607 M_ORB_INTERVAL 1 1
608 Time interval between ephemerides in seconds.
609
610 .TP 4
611 .B
612 M_ORB_EXTRATIME 1 3
613 Time in seconds before first and after last line to get ephemerides.
614 Natural splines are used to interpolate the orbits,
615 therefor some points before and after are required for
616 good interpolation.
617
618 .TP 4
619 .B
620 M_ORB_DUMP 1 0.1
621 Dump interpolated ephemerides to file "masterorbit.dat" with
622 specified delta t in seconds.
623
624 .TP 4
625 .B
626 S_ORBDIR 1 man \\
627 see
628 .ul 1
629 M_ORBDIR
630
631
632 $lines
633 .ul
634 step azimuth filtering
635 mandatory for proces: M_FILTAZI and S_FILTAZI
636
637 .TP 4
638 .B
639 AF_BLOCKSIZE 1 1024
640 fftlength per buffer. (power of 2, the larger the better).
641
642 .TP 4
643 .B
644 AF_HAMMING 1 0.75
645 De-weight and re-weight spectrum at new Doppler centroid freq.
646
647 .TP 4
648 .B
649 AF_OVERLAP 1 BLOCK/8
650 Overlap in azimuth direction between buffers.
651
652 .TP 4
653 .B
654 AF_OUT_MASTER 1 "master.afiltered"
655 Output data file name (mph complex r4) for master.
656
657 .TP 4
658 .B
659 AF_OUT_SLAVE 1 "slave.afiltered"
660 Output data file name (mph complex r4) for slave.
661
662 .TP 4
663 .B
664 AF_OUT_FORMAT 1 cr4
665 Output format either cr4 or ci2.
666 ci2 introduces an error (?) but reduces size of file by factor 2.
667
668
669 $lines
670 .ul 1
671 coarse coregistration based on precise orbits.
672 Mandatory for proces COARSEORB
673
674 .TP 4
675 .B
676 No Options for this step
677
678
679
680 $lines
681 .ul 1
682 coarse correlation (coregistration)
683 Mandatory for proces COARSECORR
684
685 .TP 4
686 .B
687 CC_METHOD 1 MAGFFT \\
688 .ul 1
689 MAGFFT
690 correlation in spectral domain based on fft's.
691 .br
692 .ul 1
693 MAGSPACE
694 correlation in space domain.
695
696
697 .TP 4
698 .B
699 CC_NWIN 1 10
700 Number of windows for correlation
701
702 .TP 4
703 .B
704 CC_IN_POS 1 opt
705 Filename with positions of windows for computation (line,pixel)
706 at each line.
707 If this card is specified, CC_NWIN is ignored.
708
709
710 .TP 4
711 .B
712 CC_WINSIZE 2 64 64
713 Number of lines pixels of correlation windows
714 .br
715 NOT TRUE: for MAGFFT: defaults to 1024, 1024
716
717
718 .TP 4
719 .B
720 CC_ACC 2 40 10
721 Search accuracy lines pixels.
722 .br
723 for MAGFFT: automatically .5*WINSIZE -L/2,L/2
724
725 .TP 4
726 .B
727 CC_INITOFF 2 0 0
728 Initial offset lines pixels.
729 .br
730 .ul 1
731 ORBIT or orbit
732 requests to read initial offset from file (placed there by coarseorb).
733
734
735
736 $lines
737 .ul
738 step fine coregistration
739 Mandatory for proces FINE
740
741 .TP 4
742 .B
743 FC_METHOD 1 MAGFFT
744 .ul 1
745 MAGFFT
746 coherence in spectral domain with fft's of magnitude images.
747 .ul 1
748 MAGSPACE
749 coherence in space domain.
750
751
752 .TP 4
753 .B
754 FC_NWIN 1 101
755 Number of windows for correlation.
756
757 .TP 4
758 .B
759 FC_IN_POS 1 opt
760 Filename with positions of windows for computation (line,pixel)
761 at each line.
762 If this card is specified, FC_NWIN is ignored.
763
764
765 .TP 4
766 .B
767 FC_WINSIZE 2 32 32
768 Number of lines pixels of correlation windows.
769
770 .TP 4
771 .B
772 FC_ACC 2 4 4
773 Search accuracy lines pixels.
774 .br
775 for ???FFT: automatically -L/2,L/2
776
777 .TP 4
778 .B
779 FC_INITOFF 2 0 0
780 Initial offset lines pixels.
781 .br
782 .ul 1
783 COARSECORR
784 requests to read initial offset from file (placed there by coarsecorr).
785
786
787 .TP 4
788 .B
789 FC_OSFACTOR 2 16
790 Oversampling factor for interpolation of correlation.
791
792
793
794 $lines
795 .ul
796 step computation of coregistration parameters.
797 mandatory for proces: COREGPM
798
799
800 .TP 4
801 .B
802 CPM_THRESHOLD 1 0.3
803 Threshold correlation for selection windows.
804
805
806 .TP 4
807 .B
808 CPM_DEGREE 1 1
809 Degree of model.
810
811
812 .TP 4
813 .B
814 CPM_WEIGHT 1 none
815 Select a priori covariance matrix.
816 .br
817 .ul 1
818 NONE no weighting is applied.
819 .br
820 .ul 1
821 LINEAR correlation is used for weighting.
822
823
824 .TP 4
825 .B
826 CPM_MAXITER 1 10
827 Maximum number of windows to remove automatically with outlier tests.
828
829
830 .TP 4
831 .B
832 CPM_NOPLOT 0 false
833 If present no plots are made.
834
835
836 $lines
837 .ul
838 step computation of reference interferogram (flat earth correction)
839 mandatory for proces: COMPREFPHA (f.k.a. FLATEARTH)
840
841
842 .TP 4
843 .B
844 FE_METHOD 1 porbits
845 Method selector for computations.
846 .br
847 .ul 1
848 PORBITS use precise orbits
849 .br
850 .ul 1
851 METHOD2 use ???
852
853
854 .TP 4
855 .B
856 FE_DEGREE 1 5
857 Degree of 2D-polynomial.
858
859
860 .TP 4
861 .B
862 FE_NPOINTS 1 501
863 Number of points for estimation of polynomial
864
865
866
867 $lines
868 .ul 1
869 step: resampling of slave to master grid
870 mandatory for proces: RESAMPLE
871
872
873 .TP 4
874 .B
875 RS_METHOD 1 cc4p
876 Method selector for computations.
877 .br
878 .ul 1
879 RECT
880 .br
881 .ul 1
882 TRI
883 .br
884 .ul 1
885 CC4P
886 .br
887 .ul 1
888 CC6P
889 .br
890 .ul 1
891 TS6P
892 .br
893 .ul 1
894 TS8P
895 .br
896 .ul 1
897 TS16P
898
899
900 .TP 4
901 .B
902 RS_OUT_FILE 1 s_resampled.raw
903 Name of output file resampled slave.
904
905
906 .TP 4
907 .B
908 RS_OUT_FORMAT 1 cr4
909 Output format either cr4 or ci2.
910 ci2 introduces an error but reduces size of file by factor 2.
911
912
913 .TP 4
914 .B
915 RS_DBOW 4 entire overlap
916 Database output window.
917 .br
918 arguments: min.line max.line min.pixel max.pixel
919 in original master system.
920 If specified window is outside overlap master, zeros are written in the slave.
921
922
923 .TP 4
924 .B
925 RS_SHIFTAZI 1 ON
926 Switch to shift the azimuth spectrum of the data to zero freq.
927 before resampling, and back to its Doppler Centroid frequency
928 after resampling.
929
930
931 $lines
932 .ul
933 step range filtering of (complex) master and slave (resampled)
934 mandatory for proces: FILTRANGE
935
936
937 .TP 4
938 .B
939 RF_METHOD 1 adaptive
940 Method selector for rangefiltering.
941 either adaptive or porbits.
942 .br
943
944
945 .TP 4
946 .B
947 RF_SLOPE 1 0.0
948 Mean terrain slope for method porbits.
949 .br
950
951
952 .TP 4
953 .B
954 RF_FFTLENGTH 1 64
955 Length of adaptive block with constant slope.
956 Resolution in range is for ERS approximately 20 meters.
957 Default for method orbit is 1024.
958 .br
959
960
961 .TP 4
962 .B
963 RF_NLMEAN 1 (odd) 15
964 Number of lines for taking mean powerspectrum of complex interferogram
965 to reduce noise for better peak estimation.
966 Only for method adaptive.
967 .br
968
969
970 .TP 4
971 .B
972 RF_HAMMING 1 0.75
973 Alpha of hamming function for weighting.
974 An alpha of 1.0 yields a rectangular filter,
975 an alpha of 0. gives more power to the low frequencies.
976 .br
977
978
979 .TP 4
980 .B
981 RF_THRESHOLD 1 5.0
982 Threshold for range filtering on SNR of peak estimation.
983 SNR is defined as fftlength*power of peak divided
984 by the power of the other frequencies.
985 Only for method adaptive.
986 .br
987
988
989 .TP 4
990 .B
991 RF_OVERSAMPLE 0 or 1 ON
992 Perform oversampling of master and slave before computing interferogram.
993 Only for method adaptive.
994 .br
995 .ul
996 ON
997 do oversampling.
998 .br
999 .ul
1000 OFF
1001 do not do oversampling.
1002
1003
1004 .TP 4
1005 .B
1006 RF_WEIGHTCORR 0 or 1 OFF
1007 Optionally weight the powerspectrum of complex interferogram
1008 to account for decreasing number of overlapping frequencies
1009 for higher frequencies.
1010 The (Hamming) shape of the spectrum is not acounted for.
1011 The effect of this card may be neglible.
1012 Only for method adaptive.
1013 .br
1014 .ul
1015 ON
1016 do weight.
1017 .br
1018 .ul
1019 OFF
1020 do not weight.
1021
1022
1023 .TP 4
1024 .B
1025 RF_OUT_MASTER 80char master.rfilter
1026 Data output file name for filtered slave.
1027 .br
1028
1029
1030 .TP 4
1031 .B
1032 RF_OUT_SLAVE 80char slave.rfilter
1033 Data output file name for filtered slave.
1034 .br
1035
1036
1037 .TP 4
1038 .B
1039 RF_OUT_FORMAT 80char cr4 | ci2
1040 Data output format either complex real4 values or casted to short integers.
1041 (for both output files)
1042 .br
1043
1044
1045
1046
1047 $lines
1048 .ul
1049 step computation of (complex) interferogram
1050 mandatory for proces: INTERFERO
1051
1052
1053 .TP 4
1054 .B
1055 INT_METHOD 1 man
1056 Method selector: old or oversample.
1057 The latter is not implemented yet.
1058 .br
1059
1060 .TP 4
1061 .B
1062 INT_OUT_CINT 1 opt
1063 Filename of complex data output file complex interferogram.
1064 .br
1065 (This file can be viewed with dismph).
1066
1067
1068 .TP 4
1069 .B
1070 INT_OUT_FE 1 opt
1071 Filename of real data output file interferogram (phase) of
1072 correction/ reference phase (flatearth correction).
1073 This is the unwrapped fase,
1074 evaluated at the points of the multilooked grid.
1075 .br
1076 If this card is present it flags to save this file.
1077
1078
1079 .TP 4
1080 .B
1081 INT_OUT_INT 1 opt
1082 Filename of real data output file containing the
1083 (wrapped) phase of complex interferogram.
1084 .br
1085 If this card is present it flags to save this file.
1086
1087
1088 .TP 4
1089 .B
1090 INT_MULTILOOK 2 5 1
1091 Multilooking factors in azimuth (line) and
1092 range (pixel) direction.
1093
1094
1095
1096 $lines
1097 .ul
1098 step subtraction of reference interferogram (flat earth correction)
1099 mandatory for proces: SUBTRREFPHA
1100
1101 .TP 4
1102 .B
1103 SRP_METHOD 1 polynomial
1104 Method selector for subtraction.
1105 Either compute ref. phase here or evaluate polynomail
1106 from step COMPREFPHA.
1107
1108 .TP 4
1109 .B
1110 SRP_OUT_CINT 1 cint.minrefpha.raw
1111 Output file name for complex interferogram.
1112
1113 .TP 4
1114 .B
1115 SRP_MULTILOOK 1 or 2 1 1
1116 Multilook factors in azimuth and range direction.
1117 Default is equal factors.
1118
1119 .TP 4
1120 .B
1121 SRP_OUT_CINT 1 cint.minrefpha.raw
1122 Output file name for complex interferogram.
1123
1124
1125 $lines
1126 .ul
1127 step phase filtering of complex interferogram
1128 mandatory for proces: FILTPHASE
1129
1130 .TP 4
1131 .B
1132 PF_METHOD 1 goldstein
1133 Method selector for phase filtering
1134 (goldstein or spatialconv or spectral),
1135
1136
1137 .TP 4
1138 .B
1139 PF_BLOCKSIZE 1 32
1140 Size per block.
1141 For goldstein method.
1142
1143
1144 .TP 4
1145 .B
1146 PF_ALPHA 1 0.2
1147 Weighting factor for spectrum [0,1] <-> [no,max].
1148 Sf = S*(A/max(A)).^PF_ALPHA
1149 Where Sf is the complex filtered spectrum,
1150 S is the complex spectrum of the interferogram,
1151 and A is the real smoothed amplitude of S.
1152 The result is the ifft2d of Sf.
1153 For goldstein method.
1154
1155
1156 .TP 4
1157 .B
1158 PF_OVERLAP 1 3
1159 Use 2*PF_OVERLAP the same data for consecutive blocks/buffers.
1160 For goldstein method.
1161
1162
1163 .TP 4
1164 .B
1165 PF_KERNEL var. 3 1 1 1
1166 KERNEL function for goldstein and spatialconv method.
1167 First specify the number of arguments, then the values.
1168 Kernel is always normalized by Doris.
1169 Default kernel for goldstein is [1 2 3 2 1],
1170 and default for spatialconv is [1 1 1].
1171 For goldstein's method this kernel is used to smooth the
1172 amplitude of the spectrum, by which the original spectrum
1173 is weighted (by smoothamplspectrum.^alpha, see PF_ALPHA).
1174 To avoid weighting, use kernel [1].
1175
1176
1177 .TP 4
1178 .B
1179 PF_IN_KERNEL2D 1 filename
1180 File name for ascii file with 2D KERNEL function.
1181 For spatialconv and spectral method.
1182 A header line should precede the kernel, containing:
1183 height width scale, e.g.,
1184 3 3 0.1111111
1185
1186 1 1 1
1187
1188 1 1 1
1189
1190 1 1 1
1191
1192
1193 .TP 4
1194 .B
1195 PF_OUT_FILE 1 cint.gf.alpha
1196 output file name.
1197 For method spatialconv, default is cint.filtered.
1198
1199
1200 .TP 4
1201 .B
1202 PF_IN_FILE 2 filename numlines
1203 Perform filtering on this file (complex float, mph) that
1204 has N lines.
1205
1206
1207 $lines
1208 .ul
1209 step computation of reference DEM (phase)
1210 mandatory for proces: COMPREFDEM
1211 Most information can be found in de .HDR file of the gtopo30 DEM.
1212
1213 .TP 4
1214 .B
1215 CRD_METHOD 1 gtopo30
1216 Method selector.
1217 not used in version $VERSION.
1218
1219 .TP 4
1220 .B
1221 CRD_IN_DEM 1 man
1222 File name of input DEM (gtopo30 only).
1223
1224 .TP 4
1225 .B
1226 CRD_IN_FORMAT 1 i16
1227 Format specifier for DEM used.
1228 Either i16, r4, or r8 for shorts, floats or doubles.
1229
1230 .TP 4
1231 .B
1232 CRD_IN_SIZE 2 6000 4800
1233 Number of rows/cols of input DEM.
1234
1235 .TP 4
1236 .B
1237 CRD_IN_DELTA 1 or 2 0.00833333333333333333
1238 Grid spacing of input DEM in decimal degrees.
1239
1240 .TP 4
1241 .B
1242 CRD_IN_UL 2 89.995833333333333 -19.995833333333333333333
1243 WGS84 coordinates of leftupper corner.
1244 In decimal degrees, latitude longitude.
1245
1246 .TP 4
1247 .B
1248 CRD_IN_NODATA 1 -9999
1249 Identifier which number to regard as Not a Number in input DEM.
1250
1251 .TP 4
1252 .B
1253 CRD_INCLUDE_FE 1 OFF
1254 Card to switch on to include 'flat earth' in this step.
1255
1256 .TP 4
1257 .B
1258 CRD_DENSE 1 4
1259 Factor for extra dense oversampling of DEM.
1260
1261 .TP 4
1262 .B
1263 CRD_OUT_DEM 1 opt
1264 If specified,
1265 a short file is dumped containing cut out of input DEM.
1266
1267 .TP 4
1268 .B
1269 CRD_OUT_DEMI 1 opt
1270 If specified, a float file is dumped containing bicubic interpolated dem.
1271
1272 .TP 4
1273 .B
1274 CRD_OUT_FILE 1 refdem.raw
1275 Filename of output file containing reference DEM.
1276
1277
1278 $lines
1279 .ul
1280 step subtraction of reference DEM (phase)
1281 mandatory for proces: SUBTRREFDEM
1282
1283 .TP 4
1284 .B
1285 SRD_OUT_CINT 1 cint.minrefdem.raw
1286 Output file name for complex interferogram.
1287
1288
1289
1290
1291
1292
1293 $lines
1294 .ul
1295 step computation of (complex) coherence image
1296 mandatory for proces: COHERENCE
1297
1298
1299 .TP 4
1300 .B
1301 COH_METHOD 1 man
1302 Method selector: old or new.
1303 The latter is not implemented yet.
1304 .br
1305
1306 .TP 4
1307 .B
1308 COH_OUT_CCOH 1 opt
1309 Filename of complex data output file coherence.
1310 .br
1311 If this card is present it flags to save this file.
1312
1313
1314 .TP 4
1315 .B
1316 COH_OUT_COH 1 opt
1317 Filename of real data output file coherence image.
1318 .br
1319 If this card is present it flags to save this file.
1320
1321
1322 .TP 4
1323 .B
1324 COH_MULTILOOK 2 10 2
1325 Multilooking factors in azimuth (line) and
1326 range (pixel) direction.
1327
1328
1329 .TP 4
1330 .B
1331 COH_WINSIZE 2 coh_multilook
1332 Windowsize for coherence computation.
1333
1334
1335
1336 $lines
1337 .ul
1338 step unwrap
1339 mandatory for proces: UNWRAP
1340
1341
1342 .TP 4
1343 .B
1344 UW_METHOD 1 ??
1345 Method selector: not implemented in doris v1.2
1346
1347 .TP 4
1348 .B
1349 UW_???
1350 ???
1351
1352
1353 $lines
1354 .ul 1
1355 step differential interferometry
1356 Mandatory for DINSAR
1357
1358 .TP 4
1359 .B
1360 DI_OUT_FILE 1 differentialinterf.raw
1361 File name of output with differential phase (complex)
1362
1363 .TP 4
1364 .B
1365 DI_IN_TOPOSLAVE 1 man
1366
1367 .TP 4
1368 .B
1369 DI_IN_TOPOINT 1 man
1370
1371 .TP 4
1372 .B
1373 DI_IN_TOPOMASTER 1 same as defo
1374
1375 .TP 4
1376 .B
1377 DI_OUT_SCALED 1 opt
1378
1379
1380
1381 $lines
1382 .ul
1383 step slant to height conversion
1384 mandatory for proces: SLANT2H
1385
1386
1387 .TP 4
1388 .B
1389 S2H_METHOD 1 ambiguity
1390 Method selector: ambiguity, schwabisch or rodriguez
1391
1392
1393 .TP 4
1394 .B
1395 S2H_NPOINTS 1 200
1396 schwabisch method: Number of points to be used for estimation of 2d polynomial.
1397
1398
1399 .TP 4
1400 .B
1401 S2H_DEGREE1D 1 2
1402 schwabisch method: Degree of 1d polynomial.
1403 .br
1404
1405
1406 .TP 4
1407 .B
1408 S2H_NHEIGHTS 1 s2h_degree1d+1
1409 schwabisch method: number of heights to evaluate reference phase on.
1410 .br
1411 Overdetermined problem if Nheights > degree1d+1.
1412
1413
1414 .TP 4
1415 .B
1416 S2H_DEGREE2D 1 5
1417 schwabisch method: Degree of 2d polynomial for the coefficients of 1d polynomial.
1418 .br
1419
1420
1421
1422 .TP 4
1423 .B
1424 S2H_OUT_HEI 1 hei.raw
1425 File name of data output file with heights.
1426
1427 .TP 4
1428 .B
1429 S2H_OUT_PHI 1 phi.raw
1430 ambiguity method: File name of data output file with heights.
1431
1432 .TP 4
1433 .B
1434 S2H_OUT_LAM 1 lam.raw
1435 ambiguity method: File name of data output file with heights.
1436
1437
1438
1439 $lines
1440 .ul
1441 step geocoding (interpolation to regular grid?)
1442 mandatory for proces: GEOCODE
1443
1444
1445 .TP 4
1446 .B
1447 GEO_OUT_LAM 1 lambda.raw
1448 Filename of outputfile longitude.
1449 .br
1450
1451 .TP 4
1452 .B
1453 GEO_OUT_PHI 1 phi.raw
1454 Filename of outputfile latitude.
1455 .br
1456
1457
1458
1459
1460
1461
1462 .SS Files
1463 ?
1464
1465 .SS See also
1466 rm_err_??.c
1467 .br
1468 plotscript
1469 .br
1470 expand()
1471 .br
1472 run
1473 .br
1474 checklist.tex
1475 .br
1476 less
1477 .br
1478 ?
1479
1480 MANEOF
1481 }
1482
1483 ##################################################################################
1484 # -b only for debugging, ... comment out
1485 #if [ "$1" = "-b" ]; then
1486 # #echo "man2ps should be invoked or something."
1487 # #printout to ps and exit
1488 # MANPG | nroff -man | more
1489 # exit 1
1490 #fi
1491 #
1492 # Print out this helpfile with keywords
1493 if [ "$1" = "-p" ]; then
1494 MANPG | nroff -man -Tlj | lp -d$THEPRINTER -onb -od -oA4
1495 exit 1
1496 fi
1497
1498 # Find out pager
1499 if [ "X$PAGER" = "X" ]; then
1500 echo "Please set environment variable PAGER. For example in csh:"
1501 echo " setenv PAGER more"
1502 PAGER="more"
1503 if [ ! "X$1" = "X" ]; then
1504 PAGER="$PAGER +/$1"
1505 fi
1506 fi
1507
1508 if [ "$PAGER" = "less" ]; then
1509 if [ "$1" = "" ]; then
1510 PAGER="less -d -e -i -r -# .8 "
1511 else
1512 PAGER="less -d -e -i -r -p$1"
1513 fi
1514 fi
1515
1516 #if [ ! -x `whence $PAGER` ]; then
1517 # echo "$PAGER not found or environment variable PAGER not set"
1518 # exit 1
1519 #fi
1520
1521 # Print to screen
1522 MANPG | nroff -man | $PAGER
1523
1524 exit 0
1525 # END
1526
1527 ## RCS info #####
1528 # $Source: /users/kampes/DEVELOP/DORIS/bin/RCS/helpdoris,v $
1529 # $Revision: 3.10 $
1530 # $Author: kampes $
1531 # $Date: 2003/08/28 14:17:09 $
1532 # $Log: helpdoris,v $
1533 # Revision 3.10 2003/08/28 14:17:09 kampes
1534 # *** empty log message ***
1535 #
1536 # Revision 3.9 2003/08/14 08:45:58 kampes
1537 # added jers info
1538 #
1539 # Revision 3.8 2003/06/24 08:32:38 kampes
1540 # release version
1541 #
1542 # Revision 3.7 2003/06/16 07:04:51 kampes
1543 # v3.6
1544 #
1545 # Revision 3.6 2003/04/14 07:10:29 kampes
1546 # added screen trace, m_in_method ers
1547 #
1548 # Revision 3.5 2003/04/14 06:35:15 kampes
1549 # doris release 3.5
1550 #
1551 # Revision 1.1 2003/04/14 06:04:40 kampes
1552 # Initial revision
1553 #
1554 # Revision 1.25 2000/12/07 13:53:36 13:53:36 kampes (B.M.Kampes)
1555 # release 3
1556 #
1557 # Revision 1.24 2000/10/24 13:46:10 13:46:10 kampes (B.M.Kampes)
1558 # doris2.6
1559 #
1560 # Revision 1.17 2000/04/05 11:37:07 11:37:07 kampes (B.M.Kampes)
1561 # range filtering
1562 #
1563 # Revision 1.16 2000/02/16 17:44:33 17:44:33 kampes (B.M.Kampes)
1564 # new cards, refdem, check release 2.2
1565 #
1566 # Revision 1.15 2000/02/09 11:22:29 11:22:29 kampes (B.M.Kampes)
1567 # new cards
1568 #
1569 # Revision 1.12 99/12/13 16:49:25 16:49:25 kampes (B.M.Kampes)
1570 # small
1571 #
1572 # Revision 1.10 99/12/02 11:34:43 11:34:43 kampes (B.M.Kampes)
1573 # place to space.
1574 #
1575 # Revision 1.8 99/11/02 11:41:11 11:41:11 kampes (B.M.Kampes)
1576 # doris v1.2 s2h geocoding
1577 #
1578 # Revision 1.6 99/10/06 16:14:47 16:14:47 kampes (B.M.Kampes)
1579 # proces to process
1580 #
1581 # Revision 1.5 99/09/21 09:11:31 09:11:31 kampes (B.M.Kampes)
1582 # removed cmplx to mag for fine
1583 #
1584 # Revision 1.4 99/09/15 14:56:46 14:56:46 kampes (B.M.Kampes)
1585 # deleted section geocoding etc.
1586 #
1587 # Revision 1.3 99/09/15 14:46:46 14:46:46 kampes (B.M.Kampes)
1588 # updated print option
1589 #
1590 # Revision 1.2 99/09/13 16:00:32 16:00:32 kampes (B.M.Kampes)
1591 # initial check in
1592 #