Geografic-Information-System/macosx/pkg/resources/ReadMe.rtf

{\rtf1\ansi\ansicpg1252\cocoartf949
{\fonttbl\f0\fswiss\fcharset0 Helvetica;\f1\fnil\fcharset238 Monaco;}
{\colortbl;\red255\green255\blue255;}
\margl1440\margr1440\vieww8680\viewh10940\viewkind0
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qc

\f0\b\fs48 \cf0 GRASS GIS\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural

\b0\fs28 \cf0 \
\
\ul Starting GRASS\ulnone  - there are a few different ways to start GRASS:\
\
- Double-click GRASS.app.\
\
- Drag a mapset folder onto GRASS.app to start GRASS in that mapset.\
\
- In a Terminal, type (substitute the correct application name if a different version is installed), the mapset path is optional:\
\

\f1\fs24 open -a "GRASS-6.3.app" \{/path/to/db/location/mapset\}\

\f0\fs28 \
\
GRASS.app opens a Terminal window to start GRASS in the normal commandline way.  After starting the Terminal it quits, leaving GRASS running in the Terminal.  While a GRASS session is running you can run GRASS.app again to start another session.\
\
On Panther and Tiger, X11 is also started regardless of the GUI you use.  On Leopard and above, X11 is started when it's needed, not immediately.\
\
\

\b Setup\

\b0 \
See GRASS {\field{\*\fldinst{HYPERLINK "http://grass.gdf-hannover.de/"}}{\fldrslt documentation}} for details on setup and use.  See Apple's \ul Help Viewer\ulnone  (from most any application's Help menu) for command documentation.\
\
By default the startup uses the included X11 Tcl/Tk for the GUI. If you have used GRASS before, 
\b it will pick up your preferences for GUI/Text
\b0 , so you should make sure they are set correctly. So if the GUI doesn't start, check your GRASS_GUI setting.\
\

\b Note:
\b0  if you use the Apple default 
\b bash
\b0  shell, make sure you don't have a 
\f1\fs24 .cshrc
\f0\fs28  init hanging around.  This could be from a previous version of OS X, or installed software might add one for some reason.  Some commands might not run correctly if this file exists, yet you are using bash, so delete it if it exists.\
\
If you don't like the 
\f1\fs24 xterm
\f0\fs28  that opens when you start X11 (you don't need it since GRASS starts in the Terminal), do the following:\
\
On Panther or Tiger, edit 
\f1\fs24 /etc/X11/xinit/xinitrc
\f0\fs28  and near the bottom add a 
\f1\fs24 #
\f0\fs28  to the beginning of the 
\f1\fs24 xterm &
\f0\fs28  line.\
\
On Leopard and above, type this in a Terminal:\
\
\pard\pardeftab720\ql\qnatural

\f1\fs20 \cf0 defaults write org.x.X11_launcher app_to_run /usr/X11/bin/xlsclients
\f0\fs28 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
\cf0 \
Something must be set for app_to_run, or X11 will not function properly, and xlsclients is regarded as safe and inconspicuous.\
\
\
After running GRASS the first time, you can change your preference for whether the GUI or Terminal-only starts by using g.gisenv.\
\

\f1\fs24 g.gisenv set="GRASS_GUI=val"\

\f0\fs28 \
Where 
\i val
\i0  is '
\f1\fs24 tcltk
\f0\fs28 ' for the GUI or '
\f1\fs24 text
\f0\fs28 ' for a plain Terminal.\
\
\

\b Addon Modules\

\b0 \
To install extra modules and user scripts, see the 
\f1\fs24 modbuild
\f0\fs28  folder in 
\f1\fs24 /Library/GRASS/$VERSION
\f0\fs28 .  (
\f1\fs24 $VERSION
\f0\fs28  is the major.minor GRASS version.)\
\
\

\b R
\b0 \
\
Using R with GRASS.app needs a bit of simple setup.  Install R for Mac OS X, at least v2.3.0.  Install the GDAL R package from the GDAL framework (there are install instructions included with that), not from a repository.  Remember to use a user level install location for extra packages.\
\
Next, install the 
\b maptools
\b0  package from CRAN binary repository with the R.app Package Installer.\
\
Finally, use the Package Installer to install the 
\b spgrass6
\b0  package from the CRAN source repository.\
\
See the GRASS {\field{\*\fldinst{HYPERLINK "http://grass.itc.it/statsgrass/grass_geostats.html"}}{\fldrslt stats}} page for info on how to use R with GRASS.\
\
\

\b MPEG\

\b0 \
There are a few different ways to create animations in GRASS.  xganim animates a series of rasters on the fly, and is useful for a quick check of an animation, but it requires Motif or Lesstif in X11 and this package may not include it.  There is a TclTk version of xganim in the TclTk GUI.\
\
The OGSF GRASS library can be built with mpeg support using the ffmpeg libraries, this is used only in NVIZ.  ffmpeg is a difficult one to build on any platform because it is in constant flux, and none of the binaries available include the libraries.  Without ffmpeg, NVIZ can only generate a series of images which can then be run through any mpeg program.  This package may have ffmpeg support.\
\
The last option built into GRASS, r.out.mpeg, starts with rasters and generates an mpeg1 video using an external program mpeg-encode (aka ppmtompeg).  The two problems with this are: mpeg1 is low quality, and you can't use it on an NVIZ image sequence, just rasters.  A copy of ppmtompeg may be included in the GRASS application package.\
\
There is also a completely external option.  There are many mpeg encoding programs available.  Pick one of your choice and feed the NVIZ image sequence to that outside of GRASS.  {\field{\*\fldinst{HYPERLINK "http://ffmpegx.com/"}}{\fldrslt ffmpegX}} is a handy package ready-made for Mac OS X.  It includes commandline binaries for ffmpeg AND many other encoders, including the popular mencoder.  You can either use the GUI, or run them from the Terminal - all the individual programs are in the app package's Resources folder, except a couple external ones in the ffmpegX Application Support.\
\
\

\b GPS\

\b0 \
A copy of gpsbabel may be included for v.in.gpsbabel to use.  If not, you need to install a separate GPSBabel application.  Serial ports (both old-style and USB) on OS X are named a little different than most 'nix systems, and they will all go thru USB, including old RS-232 serial.  You need to use the 
\f1\fs24 cu.*
\f0\fs28  ports.  All ports are in 
\f1\fs24 /dev
\f0\fs28 .\
\
Old RS-232 serial will have to go thru a Serial-USB converter, like the Keyspan USA-19W.  These will usually have a name like 
\f1\fs24 USA19QW3d1P1.1
\f0\fs28 , or 
\f1\fs24 /dev/cu.USA19QW3d1P1.1
\f0\fs28 .\
\
To figure out your GPS port, you can try the following.  With the GPS (including a serial-USB adaptor, if needed for your GPS) 
\i not
\i0  connected, type this in a Terminal:\
\

\f1\fs24 ls /dev/cu.*\

\f0\fs28 \
Then connect the GPS (with the serial-USB adaptor, if needed), and type that 
\f1\fs24 ls
\f0\fs28  command again.  Note what was added, that should be the port to use (with 
\f1\fs24 /dev/
\f0\fs28  prefixed to it).\
\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural

\fs24 \cf0 \'a9 2006-2008 by the GRASS Development Team\
This program is free software under the GNU General Public License (>=v2).\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural

\fs28 \cf0 \
\
- William Kyngesburye\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
{\field{\*\fldinst{HYPERLINK "mailto:kyngchaos@kyngchaos.com"}}{\fldrslt \cf0 kyngchaos@kyngchaos.com}}
\fs24 \
{\field{\*\fldinst{HYPERLINK "http://www.kyngchaos.com"}}{\fldrslt 
\fs28 http://www.kyngchaos.com/}}
\fs28 \
}