====== First Time Installation (v2.2.2) ====== These instructions are for users who are installing ROI_PAC on their computer system for the first time. The appropriate commands are shown in the boxes. Additional information is found in the documentation that accompanies the software. **1. Order and download ** the software from [[http://www.openchannelfoundation.org/orders/index.php?group_id=282|Open Channel Foundation]]. **2. Uncompress and untar** the archived file. <code> % tar -xzf roi_pac_dist_v2.2.2.tar.gz </code> **3. Read the documentation.** Read through the files found in $HOME/ROI_PAC_DIST/GUIDE. <code> % cd $HOME/ROI_PAC_DIST/GUIDE % less * </code> **4. Configure environmental variables.** Alter SAR_CONFIG according to the instructions found in $HOME/ROI_PAC_DIST/GUIDE/Setup and source the file. For now, you only need to change a few lines. Select the appropriate SAR_CONFIG.master.xxx based on your choice of shell (eg., csh, sh, bash). <code> % cd .. % cp SAR_CONFIG.master.xxx SAR_CONFIG % vi SAR_CONFIG % source SAR_CONFIG </code> **5. Compile executables.** You can skip this step and see if the executables in $HOME/ROI_PAC_DIST/ROI_PAC/BIN/XXX work for your system. The executable binaries provided with the installation should work for most users. Otherwise you will need to recompile everything (good luck!). <code> % cd $HOME/ROI_PAC % make clean % make all % make install % make clean </code> **6. Update path to perl.** The path to the perl executable may be different on your machine than is used in the ROI_PAC scripts. There is a simple script that will edit this path for you. <code> % cd $HOME/ROI_PAC_DIST/ROI_PAC/INT_SCR % chgperlpath.pl </code> **7. Check updates for your OS.** The identification of several bugs as well as suggestions for resolving problems have been posted by other users. You may want to browse through the offerings and refer back to this list when problems arise. Don't forget to browse the forum or post a question if you get stuck. **8. Test the installation.** You will need 3.2 Gb of free space to process a test data set. Be sure to change SAR_CONFIG (see step 3) for the test run and source it. You will want to configure SAR_CONFIG differently once you have tested the software and organized your working space. In the TEST_DIR, you will need to change the path to the DEM found in the file int.proc to $HOME/ROI_PAC_DIST/TEST_DIR/DEM/SoCal.dem.XXX. <code> % mv roi_pac_testdir.tar.gz $HOME/ROI_PAC_DIST % cd $HOME/ROI_PAC_DIST % tar xzf roi_pac_testdir.tar.gz % source SAR_CONFIG % cd TEST_DIR % cd 930110 % make_raw.pl PRC SARLEADER* 930110 % cd ../950523 % make_raw.pl PRC SARLEADER* 950523 % cd .. % process_2pass.pl int.proc </code> **9. Examine the results.** The script process_2pass.pl will take ~20 minutes (on a 2.4 GHz machine running Linux), assuming that the scripts run without interruption. You should find the directory int_930110-950523 full of files. The finished product is the file geo_930110-950523.unw. If you have the program mdx.f, then you can view the image using the script mdx.pl. Otherwise, you can try to view the file with a different program that can display binary image files (i.e., Matlab, ENVI, ERmapper). The file is composed of floating point values in a band-interleave format, i.e. alternating lines of magnitude and phase. The size of the file should be ~13 Mb. The meta-data for the file can be found in geo_930110-950523.unw.rsc. <code> % cd $HOME/ROI_PAC_DIST/TEST_DIR/int_930110_950523 % ls % mdx.pl geo_930110-950523.unw </code> |{{mag.gif?200|Magnitude of geo_930110-950523.unw}}|{{phs.gif?200|Phase of geo_930110-950523.unw}}| |{{ cbar_mag.jpg?200 }}|{{ cbar_phs.jpg?200 }}| Congratulations! If process_2pass.pl ran smoothly, then ROI_PAC is installed correctly. You are now ready to process your own SAR data. Create a workspace where you will process future data. You may also want to create a new directory where you can archive your DEM and orbit files. Remember to go back and change SAR_CONFIG to reflect your new setup.