manpagez: man pages & more
man gmtswitch(1)
Home | html | info | man
gmtswitch(1)                          GMT                         gmtswitch(1)




NAME

       gmtswitch - Switching between different GMT versions


SYNOPSIS

       gmtswitch [ D | version ]


INTRODUCTION

       gmtswitch  helps you modify your environment to allow for the switching
       back and forth between several installed GMT  versions,  in  particular
       GMT  5  and  versions  from the GMT 4 series. It works by maintaining a
       list of directories to GMT installations in a file in your home  direc-
       tory,  then  manipulates  a symbolic link to point to the GMT directory
       whose executables we wish to use [The Windows version works a bit  dif-
       ferently; see WINDOWS below].


REQUIRED ARGUMENTS

       None.  If  no  arguments  are  given  you  are presented with a menu of
       installed GMT versions from 1 to n and you specify which one  you  wish
       to switch to.


OPTIONAL ARGUMENTS

       D      Select  the  default GMT version. This is the first entry in the
              ~/.gmtversions file

       version
              Search for a unique match in the  ~/.gmtversions  file.  If  one
              match  is  found  we switch to that entry; otherwise an error is
              generated.  where module is the name of a GMT  program  and  the
              options are those that pertain to that particular program.


SETUP

       If you have official versions installed then running gmtswitch the very
       first time will examine your hard disk  starting  at  /  and  look  for
       directories  with  GMT4 or GMT5 in the name. This will fail to find the
       subversion directories and possibly others you have  placed  elsewhere.
       The fastest way to get up and running is this:

       1.

          Edit/Create  ~/.gmtversions  and  add the paths to all GMT installa-
          tions
                 you  have  or  care  to  consider. Each path goes on separate
                 lines and points to the top dir of each  distribution,  e.g.,
                 /Users/pwessel/UH/RESEARCH/PROJECTS/GMTdev/GMT4.5.7

       2.

          In  your  .bashrc  or  .[t]csrh or wherever you are maintaining your
          PATH
                 or  path variable, remove any directories you have added that
                 contain GMT, and add the new path  $HOME/this_gmt/bin  (might
                 be  $home for csh users).  Make sure this path appears before
                 any others that might contain a  GMT  installation,  such  as
                 those  used  by  package  managers  (e.g.,  /sw/bin for fink,
                 /opt/local/bin for Macports, etc.).

       3. Make the new path take effect (quit/restart terminal,  logout/login,
          etc).

       4.

          cd to the most recent GMT directory where a gmtswitch version lives,
                 and run gmtswitch with no argument. Select one of the version
                 from the menu.

       5. If in csh you may have to say rehash afterwards.

       6.

          Type apsxy -a and the synopsis should tell you that you got the
                 correct version. You can now run gmtswitch from anywhere; try
                 it  out  and  make  sure that you can switch between the ver-
                 sions.


EXAMPLES

       To switch to GMT version 4.5.7 (assuming it was installed as  such  and
       not via a package manager), try
          gmtswitch GMT4.5.7

       To switch to the default (your top choice), do
          gmtswitch D

       Finally, to select from the menu, just run
          gmtswitch

       and pick the one you want.


BEWARE

       GMT  remembers  where it was installed the first time and uses that dir
       to find the default GMT share directory. If you move entire GMT instal-
       lation after compilation then you may have to set GMT_SHAREDIR to point
       to the top dir in order for things to work. It  is  best  not  to  move
       things after installation.


WINDOWS

       Under  Windows  use  gmtswitch.bat which is a batch script that changes
       the Windows PATH variable so that the BIN directory  of  the  preferred
       version  always comes first. To do that the batch works in two alterna-
       tive modes:

       1 - Permanent mode

       2 - Temporary mode

       The permanent mode makes use of the free executable program  aEditPatha
       to  change the user path in the registry. Itas called permanent because
       the changes remains until a| next change. See

       http://www.softpedia.com/get/Tweak/Registry-Tweak/EditPath.shtml

       Of course the editpath.exe binary must be  in  your  systemas  path  as
       well.   WARNING:  The  path change will not be visible on the shell cmd
       where it was executed. For the change to be active  you  will  need  to
       open a new cmd window.

       The  second  mode  is  temporary  because  the path to the selected GMT
       binary dir is prepended to the previous path via a shell command  line.
       This  modification  disappears  when  the shell cmd window where it was
       executes is deleted.

       It is the user responsibility to set the  contents  of  the  G32_32  to
       G5_64 below to valid paths where the binaries of the different GMT ver-
       sions are installed Note that it is not mandatory to have all  four  of
       them in you computer. For the ones you do not have just let them point-
       ing to nothing e.g.,

       set G4_64=

       The permanent mode is the default one (but this  can  be  changed.  See
       edit  section) To run in the temporary mode just give a second argument
       (doesnat matter what)

       Example usage to set a GMT5 64 bits permanent

       gmtswitch g5_64

       To temporary set a GMT4 32 bits do

       gmtswitch g4_32 1

       Run without arguments to get a aUsagea (for permanent mode)


COPYRIGHT

       2017, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe



5.4.2                            Jun 24, 2017                     gmtswitch(1)

gmt5 5.4.2 - Generated Wed Jun 28 18:03:56 CDT 2017
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.