Plotting Package Installation - Revision history

Robertson at 21:03, 25 June 2010

2010-06-25T21:03:38Z

← Older revision		Revision as of 21:03, 25 June 2010
Line 1:		Line 1:
	<div class="title">Installing the ROMS/TOMS Plotting Package</div>~~__NOTOC__~~		<div class="title">Installing the ROMS/TOMS Plotting Package</div>
	The ROMS/TOMS Plotting package is a collection of Fortran programs for visualizing ROMS model output. It can be used to create publication quality, vector graphics. The '''[[Raster Scripts\|ncgm2www]]''' script is provided to facilitate raster images and animations.		The ROMS/TOMS Plotting package is a collection of Fortran programs for visualizing ROMS model output. It can be used to create publication quality, vector graphics. The '''[[Raster Scripts\|ncgm2www]]''' script is provided to facilitate raster images and animations.


	<!-- Edit Template:Plot_TOC to modify this Table of Contents-->		<!-- Edit Template:Plot_TOC to modify this Table of Contents-->
	{{Plot TOC}}		<div style="float: left;margin: 0 20px 0 0;">{{Plot TOC}}</div>__TOC__

			<div style="clear: both"></div>

	==Required Software==		==Required Software==

Robertson: /* Compiling */

2009-07-06T16:48:27Z

Compiling

← Older revision		Revision as of 16:48, 6 July 2009
Line 61:		Line 61:

	===Compiling===		===Compiling===
	Make sure you are in the src directory and issue the <span class="red">make</span> command. If the process is successful you will have <span class="red">ccnt</span>, <span class="red">cnt</span>, <span class="red">csec</span>, and <span class="red">sec</span> executables in your <span class="blue">PLT_BINDIR</span> directory. ~~At this time~~ <span class="red">cnt</span> and <span class="red">sec</span> ~~do not work properly but it is unlikely that you would wish to use them as they~~ are the ~~grayscale~~ versions of <span class="red">ccnt</span> and <span class="red">csec</span> respectively. If you need a grayscale plot use <span class="red">ccnt</span>/<span class="red">csec</span> with one of the provided "~~gray~~" palettes.		Make sure you are in the src directory and issue the <span class="red">make</span> command. If the process is successful you will have <span class="red">ccnt</span>, <span class="red">cnt</span>, <span class="red">csec</span>, and <span class="red">sec</span> executables in your <span class="blue">PLT_BINDIR</span> directory. Both <span class="red">cnt</span> and <span class="red">sec</span> are the contour only black and white versions of <span class="red">ccnt</span> and <span class="red">csec</span> respectively. If you need a grayscale plot use <span class="red">ccnt</span>'''/'''<span class="red">csec</span> with one of the provided "grey" palettes.

	<div style="float:right; margin-top: 0.0em; margin-bottom:3px; background-color: #cee0f2; padding: .2em .6em; font-size: 130%; border:1px solid #A3B1BF;">'''Next:''' '''[[Contour Plots]]''' <span style="font-size: larger; font-weight: bold;">→</span>		<div style="float:right; margin-top: 0.0em; margin-bottom:3px; background-color: #cee0f2; padding: .2em .6em; font-size: 130%; border:1px solid #A3B1BF;">'''Next:''' '''[[Contour Plots]]''' <span style="font-size: larger; font-weight: bold;">→</span>
	<div style="clear:both"></div>		<div style="clear:both"></div>
	</div>		</div>

Robertson at 15:16, 6 July 2009

2009-07-06T15:16:32Z

← Older revision		Revision as of 15:16, 6 July 2009
Line 61:		Line 61:

	===Compiling===		===Compiling===
	Make sure you are in the src directory and issue the <span class="red">make</span> command. If the process is successful you will have <span class="red">ccnt</span>, <span class="red">cnt</span>, <span class="red">csec</span>, and <span class="red">sec</span> executables in your <span class="blue">PLT_BINDIR</span> directory. At this time <span class="red">cnt</span> and <span class="red">sec</span> do not work properly but it is unlikely that you would wish to use them as they are the grayscale versions of <span class="red">ccnt</span> and <span class="red">csec</span> respectively.		Make sure you are in the src directory and issue the <span class="red">make</span> command. If the process is successful you will have <span class="red">ccnt</span>, <span class="red">cnt</span>, <span class="red">csec</span>, and <span class="red">sec</span> executables in your <span class="blue">PLT_BINDIR</span> directory. At this time <span class="red">cnt</span> and <span class="red">sec</span> do not work properly but it is unlikely that you would wish to use them as they are the grayscale versions of <span class="red">ccnt</span> and <span class="red">csec</span> respectively. If you need a grayscale plot use <span class="red">ccnt</span>/<span class="red">csec</span> with one of the provided "gray" palettes.

	<div style="float:right; margin-top: 0.0em; margin-bottom:3px; background-color: #cee0f2; padding: .2em .6em; font-size: 130%; border:1px solid #A3B1BF;">'''Next:''' '''[[Contour Plots]]''' <span style="font-size: larger; font-weight: bold;">→</span>		<div style="float:right; margin-top: 0.0em; margin-bottom:3px; background-color: #cee0f2; padding: .2em .6em; font-size: 130%; border:1px solid #A3B1BF;">'''Next:''' '''[[Contour Plots]]''' <span style="font-size: larger; font-weight: bold;">→</span>
	<div style="clear:both"></div>		<div style="clear:both"></div>
	</div>		</div>

Arango: /* Machine Dependent Include File */

2008-02-28T21:27:04Z

Machine Dependent Include File

← Older revision		Revision as of 21:27, 28 February 2008
Line 54:		Line 54:

	===Machine Dependent Include File===		===Machine Dependent Include File===
	Next you should check the paths and options of the machine dependent include file you chose with the FORT macro variable in the makefile. In particular you should check that <span class="blue">LD</span> points to the correct <span class="red">ncargf90</span> and that <span class="blue">NETCDF_INCDIR</span> and <span class="blue">~~NETCDF_INCDIR~~</span> are set correctly. It is important that your NetCDF libraries are compatible with your NCL install. The most common compatibility issue is the infamous '''second underscore problem'''. A simple google search will tell you more than you wish to know on this subject as will a search in the ROMS forum. The binary distributions of NCL 5.0.0 appear to have been built with the -fno-second-underscore compiler option set where applicable.		Next you should check the paths and options of the machine dependent include file you chose with the FORT macro variable in the makefile. In particular you should check that <span class="blue">LD</span> points to the correct <span class="red">ncargf90</span> and that <span class="blue">NETCDF_INCDIR</span> and <span class="blue">NETCDF_LIBDIR</span> are set correctly. It is important that your NetCDF libraries are compatible with your NCL install. The most common compatibility issue is the infamous '''second underscore problem'''. A simple google search will tell you more than you wish to know on this subject as will a search in the ROMS forum. The binary distributions of NCL 5.0.0 appear to have been built with the -fno-second-underscore compiler option set where applicable.

	The last thing to check is <span class="blue">FFLAGS</span>. You may have to experiment with these to get the ROMS Plotting Package to compile. For example, if you installed the 64-bit binary for x86_64 chips for Linux compiled with gcc 3.x you would would want to add <span class="blue">-fno-second_underscore</span> to <span class="blue">FFLAGS</span> in the Linux-g77.mk file.		The last thing to check is <span class="blue">FFLAGS</span>. You may have to experiment with these to get the ROMS Plotting Package to compile. For example, if you installed the 64-bit binary for x86_64 chips for Linux compiled with gcc 3.x you would would want to add <span class="blue">-fno-second_underscore</span> to <span class="blue">FFLAGS</span> in the Linux-g77.mk file.

Robertson at 21:15, 15 January 2008

2008-01-15T21:15:27Z

← Older revision		Revision as of 21:15, 15 January 2008
Line 1:		Line 1:
	<div class="title">Installing the ROMS/TOMS Plotting Package</div>__NOTOC__		<div class="title">Installing the ROMS/TOMS Plotting Package</div>__NOTOC__
	The ROMS/TOMS Plotting package is a collection of Fortran programs for visualizing ROMS model output. It can be used to create publication quality, vector graphics. ~~Two shell scripts (~~'''[[Raster Scripts~~#ncgm2gif\|ncgm2gif]]''' and '''[[Raster Scripts#ncgm2www~~\|ncgm2www]]'''~~) are~~ provided to facilitate raster images and animations.		The ROMS/TOMS Plotting package is a collection of Fortran programs for visualizing ROMS model output. It can be used to create publication quality, vector graphics. The '''[[Raster Scripts\|ncgm2www]]''' script is provided to facilitate raster images and animations.

Robertson at 21:08, 15 January 2008

2008-01-15T21:08:38Z

← Older revision		Revision as of 21:08, 15 January 2008
Line 3:		Line 3:


	~~{\|class="toc"~~		<!-- Edit Template:Plot_TOC to modify this Table of Contents-->
	\|-		{{Plot TOC}}
	~~! '''~~Table of Contents~~'''~~
	\|-
	~~\| 1. '''[[Plotting Package Installation\|Installation]]'''~~
	\|-
	~~\| 2. '''[[Contour Plots]]'''~~
	\|-
	~~\| 3. '''[[Cross-section Plots]]'''~~
	\|-
	~~\| 4. '''[[Internal Plotting Parameters]]'''~~
	\|-
	~~\| 5. '''[[Plotting Options]]'''~~
	\|-
	~~\| 6. '''[[Plotting Fields]]'''~~
	\|-
	~~\| 7. '''[[Raster Scripts]]'''~~
	\|}

Robertson at 23:22, 14 January 2008

2008-01-14T23:22:53Z

← Older revision		Revision as of 23:22, 14 January 2008
Line 13:		Line 13:
	\| 3. '''[[Cross-section Plots]]'''		\| 3. '''[[Cross-section Plots]]'''
	\|-		\|-
	\| 4. '''[[~~default.cnt\|~~Internal Plotting Parameters]]'''		\| 4. '''[[Internal Plotting Parameters]]'''
	\|-		\|-
	\| 5. '''[[Plotting Options]]'''		\| 5. '''[[Plotting Options]]'''

Robertson: New page:
Installing the ROMS/TOMS Plotting Package
NOTOC The ROMS/TOMS Plotting package is a collection of Fortran programs for visualizing ROMS model output. It can be ...

2008-01-14T23:12:00Z

New page: <div class="title">Installing the ROMS/TOMS Plotting Package</div>__NOTOC__ The ROMS/TOMS Plotting package is a collection of Fortran programs for visualizing ROMS model output. It can be ...

New page

<div class="title">Installing the ROMS/TOMS Plotting Package</div>__NOTOC__
The ROMS/TOMS Plotting package is a collection of Fortran programs for visualizing ROMS model output. It can be used to create publication quality, vector graphics. Two shell scripts ('''[[Raster Scripts#ncgm2gif|ncgm2gif]]''' and '''[[Raster Scripts#ncgm2www|ncgm2www]]''') are provided to facilitate raster images and animations.

{|class="toc"
|-
! '''Table of Contents'''
|-
| 1. '''[[Plotting Package Installation|Installation]]'''
|-
| 2. '''[[Contour Plots]]'''
|-
| 3. '''[[Cross-section Plots]]'''
|-
| 4. '''[[default.cnt|Internal Plotting Parameters]]'''
|-
| 5. '''[[Plotting Options]]'''
|-
| 6. '''[[Plotting Fields]]'''
|-
| 7. '''[[Raster Scripts]]'''
|}

==Required Software==
* [http://ngwww.ucar.edu/ NCAR Graphics] (now part of [http://www.ncl.ucar.edu/ NCL])
* [http://www.unidata.ucar.edu/software/netcdf/ NetCDF]
* [http://www.gnu.org/software/make/ GNU Make]
* Fortran 77 Compiler
* [http://www.imagemagick.org ImageMagick] (If you plan to make raster images or animations)

==Download==
The ROMS/TOMS Plotting Package is distributed via an [http://subversion.tigris.org/ SVN] repository. For more information about [http://subversion.tigris.org/ SVN] and ROMS read the '''[[Subversion]]''' page. To 'checkout' the plotting package source code issue the subversion command:

svn checkout <nowiki>https://www.myroms.org/svn/src/plot</nowiki> MyDir

If your user name on your local machine is not the same as your ROMS user name you may need to add the --username option.

svn checkout --username joeroms <nowiki>https://www.myroms.org/svn/src/plot</nowiki> MyDir

==Build==
Be sure that your '''NCARG_ROOT''' environment variable is set to the directory where [http://ngwww.ucar.edu/ NCAR Graphics] (or [http://www.ncl.ucar.edu/ NCL]) is installed. Once you have the source code downloaded, move into the src directory:

cd Mydir/src

===makefile===
You should check the user-defined options section of the makefile and edit the macro variables as needed. Below you will find a short description of each macro variable in each section.

PLT_DEBUG ?=

If set, this option will set the proper debugging compiler flag. This option is mostly used by developers and will add a 'G' to the resulting executable names (ccntG, cntG, csecG, and secG) so they will not replace the standard executables.

PLT_LARGE ?=

If set, this option will activate 64-bit compilation. Use this flag if you downloaded or compiled NCAR Graphics in 64-bit mode.

FORT ?= g77

This macro must be set to the name of your compiler. This macro tells make what compiler file to include. To see what options are available look in the Compilers directory. The files are named '''<OS>-<compiler>.mk''' so the '''Linux-g77.mk''' file is for compiling on Linux using the g77 Fortran compiler (make will automatically detect your operating system). If your OS/compiler combination is not there you can create your own. The <OS> portion of the filename is derived from the result of the uname -s command and the <compiler> portion will be whatever you set FORT to. 

If you downloaded a binary distribution of [http://www.ncl.ucar.edu/ NCL] you will need to use the same compiler that was used to make that [http://www.ncl.ucar.edu/ NCL] build. For Example, if you installed the 64-bit binary for x86_64 chips for Linux compiled with gcc 3.x you would want to use the gcc 3.x g77 compiler. If you built [http://www.ncl.ucar.edu/ NCL] from source you should use the same compiler and flags to build the ROMS Plotting Package.

NCAR_VERSION ?= NCARG441

You should only have to modify this option if you have a very old version of NCAR Graphics installed. For the Current 5.0.0 release of NCL leave this macro variable set to ''''NCARG441''''. This option changes the way calls to the NCARG libraries are made.

PLT_BINDIR ?= $(HOME)/bin

Set this option to the path where you want the plotting executables (ccnt, cnt, csec, and sec) to be installed.

===Machine Dependent Include File===
Next you should check the paths and options of the machine dependent include file you chose with the FORT macro variable in the makefile. In particular you should check that LD points to the correct ncargf90 and that NETCDF_INCDIR and NETCDF_INCDIR are set correctly. It is important that your NetCDF libraries are compatible with your NCL install. The most common compatibility issue is the infamous '''second underscore problem'''. A simple google search will tell you more than you wish to know on this subject as will a search in the ROMS forum. The binary distributions of NCL 5.0.0 appear to have been built with the -fno-second-underscore compiler option set where applicable.

The last thing to check is FFLAGS. You may have to experiment with these to get the ROMS Plotting Package to compile. For example, if you installed the 64-bit binary for x86_64 chips for Linux compiled with gcc 3.x you would would want to add -fno-second_underscore to FFLAGS in the Linux-g77.mk file.

'''NOTE:''' If you are running ROMS it is likely that your NetCDF library is already built with single underscores at the end of symbol names.

===Compiling===
Make sure you are in the src directory and issue the make command. If the process is successful you will have ccnt, cnt, csec, and sec executables in your PLT_BINDIR directory. At this time cnt and sec do not work properly but it is unlikely that you would wish to use them as they are the grayscale versions of ccnt and csec respectively.

<div style="float:right; margin-top: 0.0em; margin-bottom:3px; background-color: #cee0f2; padding: .2em .6em; font-size: 130%; border:1px solid #A3B1BF;">'''Next:''' '''[[Contour Plots]]''' →
<div style="clear:both"></div>
</div>