-
Notifications
You must be signed in to change notification settings - Fork 8
/
Copy pathREADME_bin.txt
111 lines (82 loc) · 4.32 KB
/
README_bin.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
ASF Software Read Me file for (Linux/Unix) binary installations.
####################################################################
INTRODUCTION:
If you've gotten far enough to read this note, congratulations! You've
uncompressed and untarred the software correctly. This note will tell you how
to install this ASF software you just untarred.
WHAT YOU'VE DOWNLOADED:
This file is in a directory called asf_tools, which was created when you
untarred the software. Also present in this asf_tools directory are several
sub-directories (depending on what you've downloaded, not all of these may be
present):
asf_tools+----LICENSE.txt Description of the license that goes with the
| software.
|
+----README_bin.txt How to install the binary executables and
| quick-start on documentation (if you downloaded
| executables for your platform)
|
|
+----README_rpm.txt How to validate and install the rpm (if you
| downloaded it)
|
|
+----README_src.txt How to build and install the software (if you
| downloaded source code)
|
|
+----bin This directory contains the executables.
|
|
+----man If his directory is present it contains manual
| pages for our older executables.
|
+----share This directory contains information to assist
the executables and in some cases the user.
##############################################################################
INSTALLATION:
1. ADD THE BINARIES TO YOUR PATH:
Since when you untarred our software it installed the binaries in the
<your_directory>/asf_tools/bin directory, you have to add this directory to
your PATH environment variable. Exactly how you do this depends on where you
installed the software and which UNIX shell you are using. For example, if you
installed the software in your home directory called
'/user1/yourName', you need to:
For sh, ksh, bash, or the like, add these lines to your ~/.profile or ~/.bashrc
file:
PATH=/user1/yourName/asf_tools/bin:$PATH
export PATH
For csh, tcsh, or the like, add this line to you ~/.cshrc file:
setenv PATH /user1/yourName/asf_tools/bin:$PATH
Once you have added the PATH information to a start up file as described,
exit the shell and log back in (or open a new terminal window, etc)
##############################################################################
DOCUMENTATION:
All of our newer tools feature built-in documentation. Just use the tool name,
followed by the '-help' flag, like for example this:
asf_import -help
In the case a 'man' directory is present, you will need to add the asf_tools/man
directory to your MANPATH environment variable. For example, if you installed
the ASF Tools in your home directory, the MANPATH variable should have
<your_home_directory>/asf_tools/man added to it. The exact way you do this
depends on which UNIX shell you're using:
sh/ksh/bash-- add these lines to your ~/.profile or ~/.bashrc file
MANPATH=/user1/yourName/asf_tools/man:$MANPATH
export MANPATH
(sh/tcsh-- add this line to your ~/.cshrc file
setenv MANPATH /user1/yourName/asf_tools/man:$MANPATH
As above (in INSTALLATION), you will need to restart your environment by
logging out/in or closing the terminal window and opening a new one etc.
If the above worked, you should be able to type:
man <tool_name>
and get a few pages of information about each tool you've downloaded.
##############################################################################
OTHER HELP:
1. Our web page at http://www.asf.alaska.edu has all the ASF software we offer,
tutorials, further contacts, and more.
2. In the <your_directory>/asf_tools/doc directory, you will find manuals for
the tools that you have installed, i.e. Convert2Vector, MapReady, the SAR
Training Processor, etcetera. In addition, depending on which software package
you downloaded, you will also find help documents describing how to create
a (water) mask with ArcGIS tools and a how-to on using digital elevation maps
(DEMs) for terrain correction (removal of SAR geometry effects).