Gnudraw Installation

Downloads

• gnudraw5.zip:
  Installation files, manual, examples etc.
• gnudraw5.txt:
  Textual version of these installation instructions. It is included in gnudraw5.zip.
• GnuPlot:
  On Linux/Unix, install your own version of GnuPlot from your preferred source, if it didn't come included yet in the distribution.
  On Windows, download the file gp4XXwin32.zip from http://sourceforge.net/project/showfiles.php?group_id=2055.
  On Mac OS X, first install MacPorts, followed by an installation of GnuPlot through MacPorts.

GnuDraw installation instructions

Quick install instructions

Elaborate installation instructions

1. (If you previously installed an older version of GnuDraw, delete this old installation, and then) Unzip the file gnudraw5.zip from your Ox folder (using folder names). This creates files in the directory <ox-home>/packages/gnudraw. In this case, no change of the OX6PATH environment variable is needed. Installation in a local directory is also possible; e.g. if you install under Windows in c:\myox, resulting in files in

   c:\myox\packages\gnudraw
   

   then make sure that the directory c:\myox is included in the OX6PATH variable. Note that it is important that the OX6PATH variable does not contain any spaces.

2. Unix

   Install GnuPlot if it wasn't done before, by downloading and installing the lastest rpm or other package. Use version 4.0 or higher. RPMS or deb-files should come included with your distribution, or install from source downloading from SourceForge.net

   Windows

   Install GnuPlot if it wasn't done before. Download the windows binary gp4XXwin32.zip from SourceForge.net

   Unzip the file into c:\program files\ (or c:\program files (x86)\ for 64-bit Windows), checking afterwards that the wgnuplot.exe binary indeed ended up in c:\program files\gnuplot\binary\.

   If you cannot write the binary in this directory, you can instead set an environment variable
   set GNUPLOTEXEC=f:\bin\gnuplot\binary\wgnuplot.exe
   (if you installed GnuPlot in f:\bin) to indicate the full location of the executable.

   Mac OS X

   Install GnuPlot if it wasn't done before, by first installing MacPorts downloading the dmg for your system and double-clicking on the pkg inside. Note how MacPorts depends on an installation of Apple's Xcode Developer Tools and the X11 windowing environment (see your install CD/DVD, or download and install it from the web).

   With those prerequisites (both MacPorts and Xcode) in place, type from a terminal

       sudo port upgrade --force installed
       sudo port install gnuplot 
       sudo ln -s /opt/local/bin/gnuplot /bin
       

3. Unix

   Copy (links to) the files /usr/share/OxMetrics6/ox/bin/plb2x to a directory in your path, e.g. using

   cd ~/bin
   ln -s /usr/share/OxMetrics6/ox/bin/plb2x
   

   Mac OS X

   Copy (links to) the files /Applications/OxMetrics6/ox/bin/plb2x to a directory in your path, e.g. using

   cd ~/bin
   ln -s /Applications/OxMetrics6/ox/bin/plb2x
   

   Windows

   Include the <ox-home>\bin directory in your path (if it wasn't already) or copy the files

   c:\program files\oxmetrics6\ox\bin\plb2x     
        

   to directories in your path.

4. Option A:
   Put the file <ox-home>/packages/gnudraw/doc/gnudraw.html in your list of bookmarks, or, better even,
   Option B:
   Edit <ox-home>/doc/oxmenu.html, adding a line

   <tr><td><a href="../packages/gnudraw/doc/gnudraw.html">GnuDraw graphics</a></td></tr>
   

   after the line referring to the original OxDraw documentation such that the documentation is available from the standard Ox documentation.
5. Test your installation by copying drawacf.ox to a directory where you have write permissions, and running Ox on it.

   On MacOS X, it may be that OxEdit complains

    sh: gnuplot: command not found
    

   In that case, OxEdit does not have its paths set correctly. An admittedly not ideal solution is to start OxEdit from the terminal instead of from the menu, typing

      /Applications/OxMetrics5/OxEdit.app/Contents/MacOS/OxEdit &
    

6. (Optional)
   Associate files with extension .plt with gnuplot/bin/wgnuplot.exe, with extension .plb with the batch file <ox-home>/bin/plb2x (Unix) or <ox-home>/bin/plb2x.bat (Windows)