| 1 |
-------------------------------------------------------------------- |
| 2 |
CONTENTS: |
| 3 |
1. Welcome message. |
| 4 |
2. Please acknowledge the usage of Doris in your publications. |
| 5 |
3. List of files. |
| 6 |
-------------------------------------------------------------------- |
| 7 |
|
| 8 |
|
| 9 |
|
| 10 |
|
| 11 |
Congratulations! |
| 12 |
|
| 13 |
If you are reading this message you have managed to unzip and untar |
| 14 |
the C++ source code for the Doris radar interferometric software. This |
| 15 |
directory is the one from where the core of Doris is compiled and installed. |
| 16 |
|
| 17 |
The Doris InSAR software (Delft University of Technology) can be |
| 18 |
freely used for non-commercial applications. It is released under the |
| 19 |
GPL, see the file "COPYRIGHT". For up-to-date information, see |
| 20 |
"http://doris.tudelft.nl". |
| 21 |
|
| 22 |
To install Doris, please refer to the file "INSTALL" in the root directory! |
| 23 |
The following is a summary which may be useful if the information in the |
| 24 |
INSTALL file is not enough. |
| 25 |
|
| 26 |
To install Doris, first create a "Makefile" for compilation of the |
| 27 |
source. This can be done by running the interactive csh script |
| 28 |
"configure". If you experience trouble running this script, try |
| 29 |
changing the first line to tcsh (e.g., on Cygwin systems, there is tcsh |
| 30 |
but no csh.) |
| 31 |
|
| 32 |
Please follow the instructions on the screen after the Makefile |
| 33 |
has been created. (The "Makefile" is used for convenient compilation |
| 34 |
of the source code. Basicaly execute the commands: "make", and, when |
| 35 |
compiled successfully, "make install".) |
| 36 |
|
| 37 |
Doris should compile on all (Unix like) platforms without difficulty. |
| 38 |
It has been installed on, e.g., HP-UX, SUN solaris, Linux, Windows XP |
| 39 |
running Cygwin. The GNU g++ (gcc) compiler is best used (e.g., version |
| 40 |
2.95.2). Please consult the trouble shoot section of the manual in case |
| 41 |
of trouble. One can also send an email to the doris users email list |
| 42 |
with problems on compilation. (And later with questions on processing.) |
| 43 |
See our website how to join this email list. |
| 44 |
|
| 45 |
As said, a Makefile should be generated by typing "./configure". If |
| 46 |
this however somehow fails, I also provided some example Makefiles. |
| 47 |
The Makefile I used on our system ("Makefile.sun") is for big endian, |
| 48 |
not using any libraries. |
| 49 |
The "Makefile.linux" is the result of the "configure" script |
| 50 |
for a little endian PC w/o the FFTW, Lapack, and Veclib libraries. These |
| 51 |
examples may be outdated, they only serve as examples to extend on. |
| 52 |
|
| 53 |
Then, also compile the programs in SARtools and ENVISAT_TOOLS |
| 54 |
sub directories. Perform a "make install" in all three directories |
| 55 |
to install the software. |
| 56 |
|
| 57 |
The executable (named "doris") can be tested with the test dataset |
| 58 |
that is provided on our web page (download area). Data for both big |
| 59 |
and little endian machines are available. |
| 60 |
|
| 61 |
Interferometric data processing with Doris is simplified by using the script |
| 62 |
"run" in the "bin" directory. |
| 63 |
(This utility is copied to the INSTALLDIR after "make install" is performed. |
| 64 |
Make sure the INSTALLDIR is in your path. Possibly you have to open a new |
| 65 |
terminal, or give the command "rehash" to find it.) |
| 66 |
|
| 67 |
You can test correct installation by typing "run -h", which should |
| 68 |
explain its usage. It uses the environment variables EDITOR and PAGER. |
| 69 |
Please set them to appropriate values, for example in csh add the lines |
| 70 |
setenv PAGER more |
| 71 |
setenv EDITOR nedit |
| 72 |
to your "~/.cshrc" csh resource file. |
| 73 |
|
| 74 |
Help on the keywords can be found in the manual, or by typing the command |
| 75 |
"helpdoris". |
| 76 |
|
| 77 |
Optionally a debug version can be compiled, by editing the CFLAGS variable |
| 78 |
in the Makefile. Please do this before reporting errors, and in this way |
| 79 |
try to find out more information where the error originates from. |
| 80 |
Also, a matrixclass test program can be compiled. If you are interested in |
| 81 |
using this matrix class in C++ programs of your own, it is recommended to |
| 82 |
have a look at this example program. |
| 83 |
|
| 84 |
Please also install the utility programs in the SARtools archive. With these |
| 85 |
programs you can for example view the output of Doris, and the PREVIEW |
| 86 |
card relies on proper installation of the program "cpxfiddle". |
| 87 |
|
| 88 |
It is highly recommended to install the GMT tools. Doris uses GMT |
| 89 |
for plotting the estimated offset vectors and coregistration errors. Also, |
| 90 |
the geocoded matrices latitude/longitude/height can be interpolated to a |
| 91 |
regular grid with these tools. |
| 92 |
|
| 93 |
I appreciate a message that you are using Doris, for example by sending |
| 94 |
an email to the doris_users list describing the system you compiled Doris |
| 95 |
on, and with which compiler. |
| 96 |
|
| 97 |
Please acknowledge the usage of Doris by citing the paper |
| 98 |
|
| 99 |
Bert Kampes, Ramon Hanssen and Zbigniew Perski. |
| 100 |
"Radar Interferometry with Public Domain Tools". |
| 101 |
Proceedings of FRINGE 2003, December 1-5, Frascati, Italy, 2003. |
| 102 |
|
| 103 |
Have fun! |
| 104 |
|
| 105 |
TUDelft Deos 2000-2011 |
| 106 |
[email protected] |
| 107 |
|
| 108 |
|
| 109 |
|
| 110 |
------------------------ |
| 111 |
filelist: |
| 112 |
------------------------ |
| 113 |
-rwxr-xr-x 27098 2009-01-13 20:16 bk_baseline.hh |
| 114 |
-rwxr-xr-x 14441 2009-05-30 19:58 bk_messages.hh |
| 115 |
-rwxr-xr-x 26125 2009-06-09 09:02 configure |
| 116 |
-rwxr-xr-x 28693 2009-06-08 18:03 constants.hh |
| 117 |
-rwxr-xr-x 18006 2008-09-08 13:48 COPYING |
| 118 |
-rwxr-xr-x 244256 2009-06-05 00:33 coregistration.cc |
| 119 |
-rwxr-xr-x 8086 2009-01-13 20:17 coregistration.hh |
| 120 |
-rwxr-xr-x 1528036 2009-06-09 11:47 doris |
| 121 |
-rwxr-xr-x 5708 2008-12-25 00:25 exceptions.cc |
| 122 |
-rwxr-xr-x 7405 2009-01-13 20:17 exceptions.hh |
| 123 |
-rwxr-xr-x 115971 2009-01-13 20:08 filtering.cc |
| 124 |
-rwxr-xr-x 5862 2009-01-13 20:17 filtering.hh |
| 125 |
-rwxr-xr-x 62551 2009-06-05 00:35 geocode.cc |
| 126 |
-rwxr-xr-x 4029 2009-01-13 20:17 geocode.hh |
| 127 |
-rwxr-xr-x 105179 2009-06-08 21:23 ioroutines.cc |
| 128 |
-rwxr-xr-x 7679 2009-06-08 21:18 ioroutines.hh |
| 129 |
-rwxr-xr-x 6772 2008-09-08 13:48 Makefile.bert |
| 130 |
-rwxr-xr-x 6845 2008-09-08 13:48 Makefile.cygwin |
| 131 |
-rwxr-xr-x 7181 2008-12-18 23:43 Makefile.debug |
| 132 |
-rwxr-xr-x 7162 2008-09-08 13:48 Makefile.debug-full |
| 133 |
-rwxr-xr-x 7458 2008-09-08 13:48 Makefile.doris_v3.17_MacOSX10.4_gcc4 |
| 134 |
-rwxr-xr-x 8190 2008-09-08 13:48 Makefile.sun |
| 135 |
-rwxr-xr-x 69105 2009-06-08 18:07 matrixbk.cc |
| 136 |
-rwxr-xr-x 34042 2009-06-08 17:42 matrixbk.hh |
| 137 |
-rwxr-xr-x 115649 2009-06-05 00:58 matrixspecs.cc |
| 138 |
-rwxr-xr-x 8941 2009-01-13 20:14 matrix_test.cc |
| 139 |
-rwxr-xr-x 19276 2009-06-04 23:05 newsincev2.4 |
| 140 |
-rwxr-xr-x 49146 2009-05-30 19:30 orbitbk.cc |
| 141 |
-rwxr-xr-x 8983 2009-01-13 20:18 orbitbk.hh |
| 142 |
-rwxr-xr-x 151533 2009-06-09 11:42 processor.cc |
| 143 |
-rwxr-xr-x 22899 2009-05-30 19:34 productinfo.cc |
| 144 |
-rwxr-xr-x 4888 2009-01-13 20:18 productinfo.hh |
| 145 |
-rwxr-xr-x 142235 2009-06-08 17:56 products.cc |
| 146 |
-rwxr-xr-x 5383 2009-01-13 20:18 products.hh |
| 147 |
-rwxr-xr-x 193217 2009-05-30 19:39 readdata.cc |
| 148 |
-rwxr-xr-x 3689 2009-04-12 22:00 readdata.hh |
| 149 |
-rwxr-xr-x 262556 2009-05-30 19:55 readinput.cc |
| 150 |
-rwxr-xr-x 32324 2009-05-30 19:07 readinput.hh |
| 151 |
-rwxr-xr-x 12484 2009-06-09 11:55 README |
| 152 |
-rwxr-xr-x 106922 2009-06-08 17:58 referencephase.cc |
| 153 |
-rwxr-xr-x 6959 2009-01-13 20:19 referencephase.hh |
| 154 |
-rwxr-xr-x 44130 2009-05-30 19:50 slcimage.cc |
| 155 |
-rwxr-xr-x 11725 2009-01-13 20:19 slcimage.hh |
| 156 |
-rwxr-xr-x 29405 2009-01-13 20:16 tmp_strptime.cc |
| 157 |
-rwxr-xr-x 5212 2008-09-08 13:48 TODO |
| 158 |
-rwxr-xr-x 651039 2009-03-21 23:07 triangle.c |
| 159 |
-rwxr-xr-x 21911 2008-09-08 13:48 triangle.h |
| 160 |
-rwxr-xr-x 35898 2009-01-13 20:16 unwrap.cc |
| 161 |
-rwxr-xr-x 2938 2009-01-13 20:19 unwrap.hh |
| 162 |
-rwxr-xr-x 68632 2009-06-05 00:17 utilities.cc |
| 163 |
-rwxr-xr-x 28475 2009-06-05 00:29 utilities.hh |
| 164 |
-rwxr-xr-x 2582 2008-09-06 20:08 ascii2ascii_UTM |
| 165 |
-rwxr--r-- 9202 2009-04-14 16:38 ascii2ps |
| 166 |
-rwxr-xr-x 8867 2008-09-06 20:08 ascii2ps.gmt-v3 |
| 167 |
-rwxr-xr-x 2282 2008-09-06 20:08 baseline.doris.csh |
| 168 |
-rwxr-xr-x 5506 2008-12-24 14:18 baseline.doris.sh |
| 169 |
-rwxr-x--- 17778 2009-06-04 23:37 construct_dem.sh |
| 170 |
-rwxr-xr-x 11108 2008-09-06 20:08 coregpm.doris |
| 171 |
-rwxr-xr-x 20028 2008-09-06 20:08 cpx2ps |
| 172 |
lrwxrwxrwx 15 2009-06-09 11:34 doris.process-reset.sh -> doris.rmstep.sh |
| 173 |
-rwxr-xr-x 1826 2009-05-19 16:03 doris.rmstep.sh |
| 174 |
-rwxr-xr-x 1788 2008-09-06 20:08 heightamb |
| 175 |
-rwxr-xr-x 26873 2008-09-06 20:08 helpdoris |
| 176 |
-rwxr-xr-x 3295 2008-09-06 20:08 lonlathei2ascii |
| 177 |
-rwxr-xr-x 5484 2008-09-06 20:08 phasefilt.doris |
| 178 |
-rwxr-xr-x 17927 2009-05-27 10:33 plotcpm |
| 179 |
-rwxr-xr-x 17927 2009-05-27 10:31 plotcpm.erroffsets |
| 180 |
-rwxr-xr-x 17402 2008-09-06 20:08 plotoffsets |
| 181 |
-rwxr-xr-x 17255 2008-09-06 20:08 plotoffsets.bruno |
| 182 |
-rwxr-xr-x 2771 2009-04-14 16:35 README |
| 183 |
-rwxr-x--- 64594 2009-05-30 21:02 run |
| 184 |
-rwxr--r-- 4841 2009-04-13 13:21 tsx_dump_data.py |
| 185 |
-rwxr--r-- 10496 2009-04-14 16:29 tsx_dump_header2doris_noxpath.py |
| 186 |
-rwxr--r-- 9621 2009-04-14 16:11 tsx_dump_header2doris.py |
| 187 |
-rwxr-xr-x 2516 2008-09-06 20:08 viewanddel |
| 188 |
-r--r--r-- 3582 Apr 14 18:15 2003 SARtools/Makefile |
| 189 |
-r--r--r-- 12312 Apr 14 08:30 2003 SARtools/bkconvert.cc |
| 190 |
-r--r--r-- 80779 Apr 14 08:31 2003 SARtools/cpxfiddle.cc |
| 191 |
-r--r--r-- 5040 Apr 14 08:30 2003 SARtools/cpxmult.cc |
| 192 |
-r--r--r-- 4680 Apr 14 08:30 2003 SARtools/flapjack.cc |
| 193 |
-r--r--r-- 3545 Apr 14 08:30 2003 SARtools/floatmult.cc |
| 194 |
-r--r--r-- 4789 Apr 14 08:30 2003 SARtools/rasterheader.cc |
| 195 |
-r--r--r-- 4425 Apr 14 08:30 2003 SARtools/readrasterheader.cc |
| 196 |
-r--r--r-- 5029 Apr 14 08:30 2003 SARtools/wrap.cc |
| 197 |
-r--r--r-- 2490 Jun 16 09:14 2003 ./ENVISAT_TOOLS/Makefile |
| 198 |
-r--r--r-- 5032 Jun 16 09:13 2003 ./ENVISAT_TOOLS/envisat_dump_data.c |
| 199 |
-r--r--r-- 3655 Jun 16 09:13 2003 ./ENVISAT_TOOLS/envisat_dump_header.c |
| 200 |
-r--r--r-- 836 Jun 16 09:14 2003 ./ENVISAT_TOOLS/README |
| 201 |
-r--r--r-- 4528 Jun 13 18:36 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/CHANGELOG.txt |
| 202 |
-r--r--r-- 15439 Jun 13 18:36 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/LICENSE.txt |
| 203 |
-r--r--r-- 6794 Jun 13 18:36 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/README.txt |
| 204 |
-r--r--r-- 17 Jun 13 18:36 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/VERSION.txt |
| 205 |
-r--r--r-- 4022 Jun 15 16:54 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_api.c |
| 206 |
-r--r--r-- 48996 Jun 14 14:59 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_api.h |
| 207 |
-r--r--r-- 64026 Jun 15 16:54 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_band.c |
| 208 |
-r--r--r-- 11740 Jun 14 15:00 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_band.h |
| 209 |
-r--r--r-- 29518 Jun 15 16:54 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_bitmask.c |
| 210 |
-r--r--r-- 15202 Jun 14 15:00 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_bitmask.h |
| 211 |
-r--r--r-- 12251 Jun 15 16:54 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_core.c |
| 212 |
-r--r--r-- 8473 Jun 14 15:00 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_core.h |
| 213 |
-r--r--r-- 10985 Jun 15 16:55 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_dataset.c |
| 214 |
-r--r--r-- 1723 Jun 14 15:00 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_dataset.h |
| 215 |
-r--r--r-- 527553 Jun 15 16:55 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_dddb.c |
| 216 |
-r--r--r-- 2322 Jun 14 15:00 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_dddb.h |
| 217 |
-r--r--r-- 22176 Jun 15 16:55 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_dsd.c |
| 218 |
-r--r--r-- 2922 Jun 14 15:00 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_dsd.h |
| 219 |
-r--r--r-- 7271 Jun 15 16:55 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_dump.c |
| 220 |
-r--r--r-- 9326 Jun 15 16:55 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_field.c |
| 221 |
-r--r--r-- 2131 Jun 14 15:00 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_field.h |
| 222 |
-r--r--r-- 19287 Jun 15 16:55 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_msph.c |
| 223 |
-r--r--r-- 1527 Jun 14 15:00 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_msph.h |
| 224 |
-r--r--r-- 6174 Jun 15 16:55 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_param.c |
| 225 |
-r--r--r-- 1646 Jun 14 15:00 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_param.h |
| 226 |
-r--r--r-- 14552 Jun 14 14:56 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_product.c |
| 227 |
-r--r--r-- 3357 Jun 14 14:56 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_ptrarray.c |
| 228 |
-r--r--r-- 3957 Jun 14 15:00 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_ptrarray.h |
| 229 |
-r--r--r-- 12815 Jun 15 16:56 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_record.c |
| 230 |
-r--r--r-- 2478 Jun 14 15:00 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_record.h |
| 231 |
-r--r--r-- 8945 Jun 15 16:56 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_string.c |
| 232 |
-r--r--r-- 2030 Jun 14 15:00 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_string.h |
| 233 |
-r--r--r-- 6370 Jun 15 16:56 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_swap.c |
| 234 |
-r--r--r-- 1400 Jun 14 15:01 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_swap.h |
| 235 |
-r--r--r-- 29212 Jun 15 16:56 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/epr_typconv.c |
| 236 |
-r--r--r-- 553 Jun 15 19:38 2003 ./ENVISAT_TOOLS/epr_api-2.0.1/src/Makefile |
| 237 |
-r-xr-xr-x 7316 Jun 16 09:13 2003 ./ENVISAT_TOOLS/envisat_dump_header2doris.csh |