NCL Home > Documentation > Graphics

.hluresfile

The ".hluresfile" file can be used to change some of NCL's graphical defaults.

Note that several graphical defaults have changed in NCL version 6.1.0. We will indicate below which defaults are different.

For example, in versions NCL 6.0.0 and earlier, the following graphical defaults were in effect:

In versions NCL 6.1.0 and later, the following graphical defaults are now in effect:

You can put a file called ".hluresfile" in your home directory to change graphical defaults for NCL. For example, if you don't like the new default color table for NCL, you can use this file to change it.

To create this file, look at this sample hluresfile, rename it to ".hluresfile", make any desired changes, and put it the home directory of every machine you run NCL on.

If you don't want this file in your home directory for some reason, you can call the file whatever you what, put it any directory, and set the NCARG_USRRESFILE environment variable to the full path to the file (including the filename itself).

Of course, you can modify this file and add other default changes that you want. Here's what a sample ".hluresfile" might look like:

!=========================================
! This is a sample .hluresfile. It should
! go in your home directory.
!
! Comments for ".res" files are preceded by a "!".
! Remember quotations are not used in .res files.

! White background/black foreground, these are the default in V6.1.0
*wkForegroundColor  : (/0.,0.,0./)
*wkBackgroundColor  : (/1.,1.,1./)

! Have a favorite colormap that you use for everything? You can
! make it your default here (note the name is NOT in quotes).
!
! In Version 6.1.0, the default is "ncl_default":
! http://www.ncl.ucar.edu/Document/Graphics/ColorTables/ncl_default.shtml
!
! For all available color maps, see 
! http://www.ncl.ucar.edu/Document/Graphics/color_table_gallery.shtml
*wkColorMap         : BlueWhiteOrangeRed

! Font - this is the default in V6.1.0. 
! Use times-roman to get the pre-V6.1.0 default.
*Font           : helvetica 

! Function code - this is the default in V6.1.0. 
! Use ':' to get the pre-V6.1.0 default.
*TextFuncCode               : ~     
 
! Make default X11 window larger (the default is 500x500)
*wkWidth                     : 800
*wkHeight                    : 800

! Increase the default (16mb) contour memory.
! The default is 100000000.
! For example, if you have gridded data that
! is larger than 500 x 500, you may need this.
! *wsMaximumSize: 300000000
!==========================================