Index of /pipermail/grass-user/attachments/20021212/98c688e4

[ICO]NameLast modifiedSizeDescription

[PARENTDIR]Parent Directory  -  
[TXT]README.html2007-11-14 11:05 28K 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><html><head><title>Index of /grass5/binary/mac_os_x</title></head><body bgcolor="#ffffff">
<em>Control-Click on the 'grass5install.sh' and choose 'save link to disk'.</em>

<p>
Please use the nearest mirror sites:
Mirror List: <a href="http://grass.itc.it/grass.mirrors.html">grass.mirrors.html</a>

</p><p>These binaries are distributed in the hope that they will be useful, but WITHOUT<br>
  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or<br>
  FITNESS FOR A PARTICULAR PURPOSE. Installation support for GRASS on<br>
  Mac OS X shall be <b>guaranteed</b> to be provided only to <a href="http://openosx.com/grass/">OpenOSX GRASS</a> customers.</p>
<hr>
<pre>This directory contains GRASS GIS 5.0.0 binary code for the Mac OS X 10.2.x
platform. <em>These binaries have ONLY been tested with Mac OS 10.2.1
(current version at the time of writing).</em>

[<a href="#FAQ">NEW FAQ below!</a>]

These binaries have been ported, compiled and contributed by Jeshua Lacock, the 
Owner of <a href="http://openosx.com/">OpenOSX</a>. The fastest and easiest way to install a complete
installation of GRASS on Mac OS X is accomplished with OpenOSX's <a href="http://openosx.com/grass/">GRASS
5.0.0 Package,</a> which will eliminate all the instructions and downloads outlined on this page. All of the
libraries (Xfree, Tcl/TK, Mesa, gdal, etc) have been compiled with gcc 3.1 for at least
a 20% gain in performance over previous versions (which used gcc 2.95).

Note that <em>in theory</em>, these binaries should <em>only</em> work on Mac OS 10.2.1 or later systems.
<em>All</em> required and optional libraries <em>must</em> be built on Mac OS 10.2.1 or (perhaps) later.
<hr width="100%">
Requirements for graphical user interface (GUI):

a) X-Windows:

There are many different ways to install X-Windows. One option is the package from
OS X GNU, also listed on <a href="http://www.apple.com/downloads/macosx/unix_open_source/xfree86.html">Apple's Mac OS X downloads page</a>.
Another option is <a href="http://fink.sourceforge.net">fink</a>, which can also be used to install the optional libraries (see below).

<a href="http://oroborosx.sourceforge.net/">OroborOSX</a> is a modified X-Window manager that has been modified for native Mac
OS X like features. It requires an installation of X-Free. The site also lists more detailed
infomation about running X-Windows on mac OS X.  

b) tcltkgrass GUI:
 
The above files should be moved/copied or downloaded to / (root) and installed
from there:
                                                                                
   % cd /
   % gunzip  tcltk_macosX_lib.tar.gz
   % tar -xvf tcltk_macosX_lib.tar.gz
   % gunzip  tcltkbin_macosX.tar.gz
   % tar -xvf tcltkbin_macosX.tar.gz
   
Note that these files contain an older 8.0 version of tcl/tk, so this procedure is not recommended.

Whenever possible, install the most recent version the complete tcl/tk library from <a href="http://tcl.sourceforge.net/">http://tcl.sourceforge.net/</a>.
(It is a convenient Mac OS X install package)

Not that these binaries have been compiled with Tcl/Tk 8.4 and has not been tested with
previous versions.<hr width="100%">

GRASS 5 Installation:

1. Get the GRASS binary distribution (currently 26MB):

     grass5.0.0_powerpc-apple-darwin6.1_bin.tar.bz2  (all files)

2. Also download the installation script:
     grass5_powerpc-apple-darwin6.1_install.sh

Then type the following for installation (use current package name!):

    % sh grass5_powerpc-apple-darwin6.1_install.sh grass5.0.0_powerpc-apple-darwin6.1_bin.tar.bz2
 
  This will create the necessary directories and
  files for you to run GRASS. The default install path is
  /usr/local/grass5/

  To install in a different directory, specify it in the
  command line:

        % sh grass5_powerpc-apple-darwin6.1_install.sh grass5.0.0_powerpc-apple-darwin6.1_bin.tar.bz2 /opt/grass5

You will likely need to add X11R6/bin to your search path and set your DISPLAY
variable if you are using the Terminal application.

If you want to use the native Mac OS X Tcl/Tk interface you will also need to
download and apply the file 'gui.tcl.MacOSX.TclTk.patch'.

If you want to use NVIZ, you will need to download and apply the
file 'widgets.tcl.OpenOSX.patch'.

-------
How to apply a patch:
widgets.tcl.OpenOSX.patch:
    cp widgets.tcl.OpenOSX.patch /usr/local/grass5/etc/nviz2.2/scripts/
    cd /usr/local/grass5/etc/nviz2.2/scripts/
    patch -p1 &lt; widgets.tcl.OpenOSX.patch

gui.tcl.OpenOSX.TclTk.patch:
    cp gui.tcl.OpenOSX.TclTk.patch /usr/local/grass5/tcltkgrass/main/
    cd /usr/local/grass5/tcltkgrass/main
    patch -p1 &lt; gui.tcl.OpenOSX.TclTk.patch

-------

After installation please enter:
        % source /etc/csh.cshrc /etc/csh.login
(Mac won't find the start script otherwise).

Then start GRASS with

        % grass5

The user interface is started within GRASS:
        % tcltkgrass &amp;

Note: If you are starting from the beginning, you have 
to define your project area within GRASS before 
accessing the "tcltkgrass" user interface.

For some funcionalities of GRASS (e.g. the PNG or GDAL driver) you need to install
additional UNIX-libraries. (All of the optional and required libraries are installed by the
OpenOSX <a href="http://openosx.com/grass/">GRASS Package</a>, or can either be compiled or installed from packages (when available)
with <a href="http://fink.sourceforge.net">fink.</a>).  The most recent stable version must be used, and all
libraries must be built with gcc 3.1. The list of optional libraries and their home pages are:</pre>
<ul>
  <li><code>libncurses4.x/5.x (already installed on modern systems)<br>
    <a href="http://www.gnu.org/software/ncurses/ncurses.html">http://www.gnu.org/software/ncurses/ncurses.html</a>     <br>
    <a href="ftp://ftp.gnu.org/pub/gnu/ncurses/">ftp://ftp.gnu.org/pub/gnu/ncurses/</a><br>
    </code></li>
  <li><code>Mesa-3.x (openGL clone) required for NVIZ2.2<br>
    <a href="http://mesa3d.sourceforge.net/">http://mesa3d.sourceforge.net/</a><br>
    </code></li>
  <li><code>FFTW (library for computing the Discrete Fourier Transform) 
    required for i.fft and i.ifft modules<br>
    <a href="http://www.fftw.org/">http://www.fftw.org</a> <br>
    </code></li>
  <li><code>libpng (for r.in.png, r.out.png), usually already 
    installed.<br>
    <a href="http://www.libpng.org/pub/png/libpng.html">http://www.libpng.org/pub/png/libpng.html</a>     <br>
    </code></li>
  <li><code>libjpeg (for r.in.tiff, r.out.tiff), usually already 
    installed.<br>
    <a href="http://www.ijg.org/">http://www.ijg.org</a><br>
    <a href="ftp://ftp.uu.net/graphics/jpeg/">ftp://ftp.uu.net/graphics/jpeg/</a>     <br>
    </code></li>
  <li><code>libtiff (for r.in.tiff, r.out.tiff), usually already 
    installed.<br>
    <a href="http://www.libtiff.org/">http://www.libtiff.org</a> <br>
    </code></li>
  <li><code>libgd (for PNG driver), preferably GD 2.x.<br>
    <a href="http://www.boutell.com/gd/">http://www.boutell.com/gd/</a> <br>
    </code></li>
  <li><code>netpbm-tools/libraries (for r.in.png/r.out.png), usually 
    already installed.<br>
    [please look at any decent software mirror near you!]<br>
    <a href="http://sourceforge.net/projects/netpbm/">http://sourceforge.net/projects/netpbm/</a>     <br>
    </code></li>
  <li><code>PostgreSQL libraries (for the PostgreSQL database 
    interface)<br>
    <a href="http://www.postgresql.org/">http://www.postgresql.org</a> <br>
    NOTE: An easy installation package of postgreSQL for Mac OS X is available from <a href="http://www.entropy.ch">Marc Liyanage</a><br>
    </code></li>
  <li><code>Unix ODBC (for the ODBC database interface)<br>
    <a href="http://www.unixodbc.org/">http://www.unixodbc.org</a> <br>
    </code></li>
  <li><code>Only required for "xanim" and "ogl3d": the Motif or 
    Lesstif libraries<br>
    <a href="http://www.lesstif.org/">http://www.lesstif.org</a> <br>
    </code></li>
  <li><code>r.in.gdal requires GDAL - Geospatial Data Abstraction 
    Library<br>
    <a href="http://www.remotesensing.org/gdal/">http://www.remotesensing.org/gdal/</a>     <br>
    </code></li>
  <li><code>R language (for the R language interface)<br>
    <a href="http://cran.r-project.org/">http://cran.r-project.org</a> <br>
    NOTE: There is an installation package for OS X, but be sure to install the X11
version if you want to use it with grass,
    and NOT the carbon version <br>
    </code></li>
  <li><code>FreeType2 (for d.text.freetype)<br>
    <a href="http://www.freetype.org/">http://www.freetype.org/</a> </code></li>
</ul>
 <pre>

Note that for packages that need to be compiled, you need the most recent developer tools,
that are provided on the apple website (free registration as developer required)

IMPORTANT: if grass can't find wish (from tcl/tk), you should make a link to wish8.4,
or whatever version you have installed, in /usr/local/bin/:

        % ln -s /usr/local/bin/wish8.4 /usr/local/bin/wish
      

<hr width="100%"><a name="FAQ"></a>
FAQs:

Question:

 I recently installed GRASS 5 pre3 precompiled binaries on Mac OSX, 
 and am getting an error when I start NVIZ:


  tsdptr 4729744 datakey 4729744
  start search mainPtr 0
  called create main window
  assigning interp 4700480
  tsd is 4729744 datakey 4729744
 Application initialization failed: Can't find a usable tk.tcl in the 
 following directories:
     /System/Library/Tcl/tk8.3 /usr/local/grass5/etc/lib/tk8.3 
 /usr/local/grass5/
 lib/tk8.3 /usr/local/grass5/etc/library /usr/local/grass5/library 
 /usr/local/gra
 ss5/tk8.3/library /usr/local/tk8.3/library
 
 There is, however, an installation of tk8.3 at /usr/X11R6/lib. Where 
 in Mac OSX can I tell the system to look for tk8.3? I don't 
 see it in any of the GRASS startup scripts; I think it's somewhere in 
 OSX.


Answer:

 Actually, I think that the problem is that the MacOS X version of Tk
 locates the files using a "hack" which only works for the supplied
 "wish" executable.

 Basically, the directories which are searched are relative to the
 location of the executable (apart from /System/Library).

 If you examine the list of directories:

        /System/Library/Tcl/tk8.3
        /usr/local/grass5/etc/lib/tk8.3 
        /usr/local/grass5/lib/tk8.3
        /usr/local/grass5/etc/library
        /usr/local/grass5/library 
        /usr/local/grass5/tk8.3/library
        /usr/local/tk8.3/library

  and note that the executable pathname is:

        /usr/local/grass5/etc/nviz2.2/NVWISH2.2

 it appears that the search path is effectively:

        /System/Library/Tcl/tk8.3
        /usr/local/grass5/etc/nviz2.2/../lib/tk8.3
        /usr/local/grass5/etc/nviz2.2/../../lib/tk8.3
        /usr/local/grass5/etc/nviz2.2/../library
        /usr/local/grass5/etc/nviz2.2/../../library
        /usr/local/grass5/etc/nviz2.2/../../tk8.3/library
        /usr/local/grass5/etc/nviz2.2/../../../tk8.3/library


 AFAICT, the above behaviour is hard-coded into the tk shared library. 
 This will work for wish, assuming that both wish and the tk8.3
 directory are installed into the bin and lib subirectories of a common
 parent directory. It won't work for other programs which use the tk
 library, though.

 The simplest workaround would be to try making a symlink within
 $GISBASE/lib, e.g.

        % ln -s /usr/X11R6/lib/tk8.3 /usr/local/grass5/lib/tk8.3


Question:
 A Mac OS X (pb and 1.0) user tries to fire up GRASS, the following
 error occurs:

        Error opening terminal: vt100

Answer: 

        % grass5 -tcltk

 The solution (kudos to strobe) is to cd to the directory where your
 spearfish directory is (i.e. if its found in /opt/spearfish, cd /opt)
 and enter the following:

        % grass5 spearfish/PERMANENT


Question:
 I downloaded GRASS for Mac OS X as many other people ;-). I realized
 however that for running the interface I need to logout and enter as
 &gt;console (and subsequently start the X-Windows manager) . Do you know of
 any solution that let me stay inside the normal Mac OS X environment?
                                                                                
Answer: 
Try <a href="http://oroborosx.sourceforge.net/">OroborOSX</a>. It makes Xfree86 run side by side within
 the quartz engine. More information can be found at that site. OrborOSX and
XFree are installed by OpenOSX's GRASS Package.
                                                                                

<hr width="100%">
Paint driver notes:

1) If you have local paint devices, you will need 
move the appropriate files from 
$GISBASE/etc/paint/driver.uninst to the driver.sh 
in the same directory.  In addition, you must create 
a symbolic link (using the 'ln -s' command) from 
/dev/[paint driver name] to /dev/ttya or /dev/ttyb 
(or whichenver system device your print device is 
plugged in too).  For example, if you have a 
xerox4020 connected to /dev/ttya, use

        % cd $GISBASE/etc/paint/driver.uninst
        % mv xerox4020 ../driver.sh
        % ln -s /dev/ttya /dev/xerox4020
        % chmod 0666 /dev/xerox4020

You will have to be root to create the symbolic 
link in /dev.


2) If you have a paint device which exists on a 
remote host whose GISBASE is difference from the 
local GISBASE you will need to update the value 
of GISBASE in etc/paint/driver.rsh.


3) If you plan to use v.digspline and have any  
digitizers copy the file etc/digcap.sampl to 
etc/digcap and edit it accordingly.


USING THE BINARY VERSION
------------------------

The binary version does not come with any data or 
documentation (except for on-line man pages).  You will
need to acquire whatever documents you like from the GRASS 
Research Group FTP server.  Sample data is also available 
from the FTP site, or you may use data from previous
versions of GRASS if you have it available.

***********************************************

If you experience any problems, you may email
us at:    

  <a href="mailto:GrassDownload@OpenOSX.com">GrassDownload@OpenOSX.com</a>
  <a href="http://openosx.com/grass/">http://OpenOSX.com/grass/</a>
  Jeshua Lacock, OpenOSX
  
Bug report form: <a href="http://grass.itc.it/bugtracking/bugreport.html">go here!</a>.

Get this <a href="http://grass.itc.it/grass5/binary/mac_os_x/README.html">file.</a>

Updated $Date: 2002/12/05 $
</pre>
</body></html>