SED navigation bar go to SED home page go to Dataplot home page go to NIST home page SED Home Page SED Staff SED Projects SED Products and Publications Search Dataplot Pages

Downloading DATAPLOT for OS X 10.9 (Mavericks)

Contact Information October 2016

Alan Heckert
Statistical Engineering Division
National Institute Of Standards and Technology
Gaithersburg, Md. 20899-8980
(301) 975-2899
alan.heckert@nist.gov
Jim Filliben
Statistical Engineering Division
National Institute Of Standards and Technology
Gaithersburg, Md. 20899-8980
(301) 975-2855
james.filliben@nist.gov

Introduction This page contains the intstructions for downloading and installing Dataplot on the OS X 10.9 (Maverick) operating system.

The download files contain both a pre-built executable file and the source code in case you need to build from source. The pre-built executable was built on an OS X 10.9 system using version 4.9 of the gfortran compiler.

Be aware that this is a "Unix/X11" port as oppossed to a "native" OS X application. There are two ways you can run Dataplot under OS X.

  1. You can run Dataplot in a traditional command line mode (this will be referred to as the command line version).

    The command line version can be run from either an X11 terminal window or a standard terminal window.

  2. Alternatively, you can run a Graphical User Interface (GUI). The GUI for Dataplot is written using the Tcl/Tk scripting language.
Prerequisites Before installing Dataplot, the following prerequisites are required.
  1. If X11 is not installed on your system, then you need to install it. The Dataplot executable was built and tested with the version of X11 from Apple.

  2. The runtime libraries for gfortran and gcc need to be installed to run the pre-built executable. If you need or want to build Dataplot from source, you need to install the full gcc/gfortran compilers.

    Dataplot was built using the gcc/gfortran version 4.9 binaries downloaded from

    http://hpc.sourceforge.net/

    This page gives the installation instructions.

    If you use the pre-built Dataplot executable, you only need the gfortran run time library. This is included as part of the installation files. See below for instructions on how to install this file.

  3. Dataplot uses the Aquaterm library to generate screen graphics for the command line version of Dataplot when it is run from a standard terminal window. If Aquaterm is not installed on your system, download and run AquaTerm-1.1.1.dmg.

  4. The pre-built Dataplot executable was built using several libraries that were installed using Mac Ports. Mac Ports is an open source project that has ported a large number of open source software (18,000+ packages) projects to OS X. The Mac Ports software can be downloaded from http://www.macports.org/.

    Once Mac Ports is installed, you can install a desired software using the command

    sudo port install <name>

    where <name> is the name of the desired software.

    Mac Ports will install the libraries in the directory

      /opt/local/lib

    As these libraries are used by a number of Unix/Linux programs, it is possible that some or all of these may already be installed on your system. It is also possible that they may have been installed by something other than Mac Ports, so they may not be in "/opt/local/lib". If the desired libraries are not in "/opt/local/lib", we recommend that you install them using Mac Ports so that the Dataplot executable can find them.

    The specific libraries of interest are the following.

    1. GD - the GD graphics library is used to plot in the jpeg, png, gif, bmp, wbmp, tga, and tiff image formats. You can also read images in these formats. GD in turn requires several additional libraries: png, jpeg, z, freetype, pthreads, fontconfig, and tiff.

      If you need to install the GD library, enter (assuming Mac Ports is already installed)

        sudo port install gd2

      Note that installing the gd library should install the other libraries if needed.

    2. readline - the readline library supports command line editing and history recall (with editing).

      If you need to install the readline library, enter (assuming Mac Ports is already installed)

        sudo port install readline

    3. libplot - this is an older graphics library supported under Unix/Linux. Dataplot uses libplot to support some additional graphics formats not otherwise supported.

      If you need to install the libplot library, enter (assuming Mac Ports is already installed)

        sudo port install xorg-libXaw
        sudo port install plotutils

    4. tcl/tk - Dataplot implements its GUI using the Tcl/Tk scripting language. If you are not interested in the GUI, you can skip this step.

      Note that if you want to use a version of Tcl/Tk other than the one provided by Mac Ports, you will need to manually edit two files (see below). Be aware that the Mac version ...

      To install the tcl/tk software, enter (assuming Mac Ports is already installed)

        sudo port install tcl
        sudo port install tk

Downloading Dataplot Step 1: Select Root Directory for Dataplot Installation The first step is to select the "root" directory for the Dataplot installation. Although you can make this any directory that is convenient to you, we recommend using one of the following choices:

  • /usr/local - this is the recommended choice if you have administrator priveleges on your system.

  • /Users/name - here "name" refers to your user name on your local system. This is the recommended choice if you do not have administrator priveleges on your system. The environment variable "$HOME" should refer to this directory.

If you do not use "/usr/local", then you will need to edit some files (described below) to specify correct paths.

Whatever directory you choose, we will refer to this as the Dataplot root directory in the discussion below.

Step 2: Download and Unpack the Installation File The next step is to download the Dataplot installation file dataplot.mavericks.2014_07_31.tar.gz.

Assuming that you have downloaded or copied the installation file to the Dataplot root directory, you can unpack these files with the commands

    sudo gunzip dataplot.mavericks.2014_07_31.tar.gz
    sudo tar -xvf dataplot.mavericks.2014_07_31.tar.gz
If you did not install Dataplot in the "/usr/local" directory or you are using a version of Tcl/Tk not in "/opt/local", then you need to edit the following files.
  • bin/dataplot - This initiates the command line version of Dataplot. Change the line

      dataplot_prefix=/usr/local

    to the Dataplot root directory for your system.

  • bin/xdataplot - This initiates the GUI version of Dataplot. Change the lines

      dataplot_prefix=/usr/local tcl_prefix=/opt/local/lib

    to reflect the correct paths for your system.

  • lib/dataplot/frscript/xdp - This initiates the Tcl/Tk script for the GUI. If you are not using the Mac Ports version of Tcl/Tk, then the first line of this file

      #!/opt/local/bin/wish

    should be changed to reflect the correct path for wish. This will typically be either

      #!/usr/local/bin/wish

    or

      #!/usr//bin/wish

You also need to add the Dataplot "bin" directory to your default path. For example, if you installed the Dataplot files in "/Users/heckert" and you run the c-shell or t-shell, then you can add the line

    set path=($path /Users/heckert/bin)
to your .cshrc file. If you run the Bourne shell, then add the lines
    PATH=/Users/heckert/bin:$PATH; export PATH
to your .bashrc file.

Since many sites have special customizations for these files, we do not do this automatically. Also, this does not take effect until you reboot your system. You can enter these commands manually if you do not want to reboot.

The directory "lib/dataplot_auxillary_lib" contains copies of the various external libraries used by Dataplot. Specifically,

  1. If you need to install the Fortran run time library, do the following.

      cd <Dataplot root directory>/lib/dataplot_auxillary_lib
      sudo cp libgfortran.* /usr/local/lib

  2. The other libraries in this directory are the libraries created by the Mac Ports installs (with the exception of Tcl/Tk). If for some reason you cannot use the Mac Ports, then you can try doing

      cd <Dataplot root directory>/lib/dataplot_auxillary_lib
      sudo mkdir /opt
      sudo mkdir /opt/local
      sudo mkdir /opt/local/lib
      sudo cp lib* /opt/local/lib

Building from Source The source code for Dataplot is included in the "dataplot/src" directory. If you want to build Dataplot from the source code, see the file "build_gfortran". This is a c-shell script for building Dataplot. There are a number of switches that can be set at the beginning of the file that determine which external libraries to use. On an initial build, we recommend turing off the gd, libplot, and readline options. Once the basic build is working, then you can try turning these libraries back on.

If you need assistance, then feel free to contact Alan Heckert for assistance.

Problems with Downloading
Installation Problems If you have problems with the installation, contact Alan Heckert for assistance.

Privacy Policy/Security Notice
Disclaimer | FOIA

NIST is an agency of the U.S. Commerce Department.

Date created: 07/30/2014
Last updated: 10/03/2016

Please email comments on this WWW page to alan.heckert@nist.gov.