<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> <!--Converted with LaTeX2HTML 2002-2-1 (1.71) original version by: Nikos Drakos, CBLU, University of Leeds * revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan * with significant contributions from: Jens Lippmann, Marek Rouchal, Martin Wilck and others --> <HTML> <HEAD> <TITLE>1.1.6 Overview of GMT 4.3.0 [May-1, 2008]</TITLE> <META NAME="description" CONTENT="1.1.6 Overview of GMT 4.3.0 [May-1, 2008]"> <META NAME="keywords" CONTENT="GMT_Docs"> <META NAME="resource-type" CONTENT="document"> <META NAME="distribution" CONTENT="global"> <META NAME="Generator" CONTENT="LaTeX2HTML v2002-2-1"> <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> <LINK REL="STYLESHEET" HREF="GMT_Docs.css"> <LINK REL="next" HREF="node17.html"> <LINK REL="previous" HREF="node15.html"> <LINK REL="up" HREF="node10.html"> <LINK REL="next" HREF="node17.html"> </HEAD> <BODY bgcolor="#ffffff"> <!--Navigation Panel--> <A NAME="tex2html2688" HREF="node17.html"> <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> <A NAME="tex2html2682" HREF="node10.html"> <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> <A NAME="tex2html2676" HREF="node15.html"> <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> <A NAME="tex2html2684" HREF="node1.html"> <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> <A NAME="tex2html2686" HREF="node255.html"> <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> <BR> <B> Next:</B> <A NAME="tex2html2689" HREF="node17.html">1.1.7 Overview of GMT</A> <B> Up:</B> <A NAME="tex2html2683" HREF="node10.html">1.1 What is new</A> <B> Previous:</B> <A NAME="tex2html2677" HREF="node15.html">1.1.5 Overview of GMT</A> <B> <A NAME="tex2html2685" HREF="node1.html">Contents</A></B> <B> <A NAME="tex2html2687" HREF="node255.html">Index</A></B> <BR> <BR> <!--End of Navigation Panel--> <H2><A NAME="SECTION00916000000000000000"> 1.1.6 Overview of </A><A NAME="tex2html408" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> 4.3.0 [May-1, 2008] </H2> <P> Changes are once again a mix of structural improvements, bug fixes, and a few enhancements. The coastline files (now GSHHS 1.10) have seen minor modifications, the mex supplement now offers support for <A NAME="tex2html409" HREF="http://www.octave.org"><I>Octave</I></A>, all source code is now fully 64-bit compliant, we have added an isolation mode option (if <B>GMT_TMPDIR</B> is defined, write temporary and hidden files to that directory), and the configure/make setup has been further improved (such as honoring CFLAGS and LDFLAGS set by user). Colors may now be specified as hexadecimal codes (e.g., #ff0000 for red), and projections can be specified by name (similar to <A NAME="tex2html410" HREF="http://proj.maptools.org"><I>Proj4</I></A>). Finally, binary table data can now be COARDS-compliant netCDF files. As for documentation, we have now switched from C shell to Bourne shell (although the <I>csh</I><A NAME="4128"></A> examples are still distributed). <P> The following lists specific enhancements or new program options: <P> <OL> <LI><A NAME="tex2html411" HREF="../man/gmt_grdio.c.html"><I><B>gmt_grdio.c</B></I></A><A NAME="4132"></A> is modified so the grid i/o supports the <B>GMT_[DATA<IMG WIDTH="8" HEIGHT="31" ALIGN="MIDDLE" BORDER="0" SRC="img12.png" ALT="$\vert$">IMG<IMG WIDTH="8" HEIGHT="31" ALIGN="MIDDLE" BORDER="0" SRC="img12.png" ALT="$\vert$">GRID]DIR</B> environment settings. </LI> <LI><A NAME="tex2html412" HREF="../man/gmt_init.c.html"><I><B>gmt_init.c</B></I></A><A NAME="4137"></A> was enhanced so <B>-U</B> can now interpret a justification (e.g., <I>just/dx/dy</I> on the command line or by setting <B>UNIX_TIME_POS</B>) and we introduced a new default parameter <B>UNIX_TIME_FORMAT</B> which controls the formatting of the timestamp. </LI> <LI><A NAME="tex2html413" HREF="../man/gmt_io.c.html"><I><B>gmt_io.c</B></I></A><A NAME="4143"></A> now implements <B>-b</B>[<B>i</B><IMG WIDTH="8" HEIGHT="31" ALIGN="MIDDLE" BORDER="0" SRC="img12.png" ALT="$\vert$"><B>o</B>]<B>c</B>[<I>var1/...</I>] option to indicate input is netCDF. </LI> <LI><A NAME="tex2html414" HREF="../man/gmtmath.html"><I><B>gmtmath</B></I></A><A NAME="4149"></A> recognizes new constants <B>TMIN</B>, <B>TMAX</B>, <B>TINC</B>, and <B>N</B>. </LI> <LI><A NAME="tex2html415" HREF="../man/grdimage.html"><I><B>grdimage</B></I></A><A NAME="4154"></A> uses <B>-N</B> to not clip image at map boundary. </LI> <LI><A NAME="tex2html416" HREF="../man/grdview.html"><I><B>grdview</B></I></A><A NAME="4160"></A> now uses <B>-Wf</B> to change the facade pen from its default value. </LI> <LI><A NAME="tex2html417" HREF="../man/grdmath.html"><I><B>grdmath</B></I></A><A NAME="4166"></A> recognizes new constants <B>XMIN</B>, <B>XMAX</B>, <B>XINC</B>, <B>NX</B>, and similarly <B>YMIN</B>, <B>YMAX</B>, <B>YINC</B>, <B>NY</B>. </LI> <LI><A NAME="tex2html418" HREF="../man/mapproject.html"><I><B>mapproject</B></I></A><A NAME="4171"></A> <B>-G+</B> will compute distances between coordinates in first 4 columns. </LI> <LI><A NAME="tex2html419" HREF="../man/ps2raster.html"><I><B>ps2raster</B></I></A><A NAME="4177"></A> has new option <B>-D</B> to specify alternative output directory and <B>-V</B> to report progress. </LI> <LI><A NAME="tex2html420" HREF="../man/psrose.html"><I><B>psrose</B></I></A><A NAME="4184"></A> has new option <B>-F</B> to disable the plotting of the scale bar. </LI> <LI><A NAME="tex2html421" HREF="../man/psxyz.html"><I><B>psxyz</B></I></A><A NAME="4190"></A> has new option <B>-D</B> to match option set in <A NAME="tex2html422" HREF="../man/psxy.html"><I><B>psxy</B></I></A><A NAME="4196"></A>. </LI> <LI><A NAME="tex2html423" HREF="../man/mgd77/mgd77list.html"><I><B>mgd77/mgd77list</B></I></A><A NAME="4201"></A> added <B>-Ga</B><IMG WIDTH="8" HEIGHT="31" ALIGN="MIDDLE" BORDER="0" SRC="img12.png" ALT="$\vert$"><B>b</B><I>rec</I> to limit output to a certain record range. </LI> <LI><A NAME="tex2html424" HREF="../man/spotter/hotspotter.html"><I><B>spotter/hotspotter</B></I></A><A NAME="4207"></A> added <B>-S</B> to normalize output to percent of CVA maximum. </LI> <LI><A NAME="tex2html425" HREF="../man/spotter/grdspotter.html"><I><B>spotter/grdspotter</B></I></A><A NAME="4213"></A> is a new program, like <A NAME="tex2html426" HREF="../man/hotspotter.html"><I><B>hotspotter</B></I></A><A NAME="4218"></A>, but using gridded data as input. </LI> </OL> <P> A long list of bugs has been squashed since the last release, the most important are listed below: <P> <DL> <DT><STRONG><A NAME="tex2html427" HREF="../man/gmt_grdio.c.html"><I><B>gmt_grdio.c</B></I></A><A NAME="4223"></A></STRONG></DT> <DD>: Fixed 3 bugs in <TT>GMT_decode_grd_h_info</TT> that caused problems parsing <B>-D</B> option. Explicitly exclude = sign from becoming separator. </DD> <DT><STRONG><A NAME="tex2html428" HREF="../man/gmt_io.c.html"><I><B>gmt_io.c</B></I></A><A NAME="4230"></A></STRONG></DT> <DD>: Now skips blank lines that has leading whitespace. </DD> <DT><STRONG><A NAME="tex2html429" HREF="../man/gmt_init.c.html"><I><B>gmt_init.c</B></I></A><A NAME="4235"></A></STRONG></DT> <DD>: <B>c</B> for seconds was not recognized as <B>TIME_UNIT</B> (expected <B>s</B>, which is kept for backwards compatibility). <B>-B</B> processing of labels used an internal string that was too short, which could lead to label truncation. Fixed ``Holiday-bug'' in <TT>GMT_parse_J_option</TT> introduced 2007-12-21. <TT>GMT_str_tolower</TT> could run out of bounds. Probably only affected 32-bit compilers. <TT>GMT_is_a_blank_line</TT> is now used wherever ascii input is processed. </DD> <DT><STRONG><A NAME="tex2html430" HREF="../man/gmt_map.c.html"><I><B>gmt_map.c</B></I></A><A NAME="4244"></A></STRONG></DT> <DD>: Fixed bug in radial clipping. The radial clipping would sometimes add arcs using the arc that exceeds 180 degrees. Added new rectangular clip function using Sutherland/Hodgman algorithm in order to fix incorrect results in <A NAME="tex2html431" HREF="../man/grdlandmask.html"><I><B>grdlandmask</B></I></A><A NAME="4249"></A>. Minor bug in 4th term in conformal to geodetic lat. Round-off could mess mapping of west/east to xmin/xmax. Now has a safety valve for checking that this does not occur. </DD> <DT><STRONG><A NAME="tex2html432" HREF="../man/gmt_plot.c.html"><I><B>gmt_plot.c</B></I></A><A NAME="4254"></A></STRONG></DT> <DD>: 3-D basemap axis did not use <B>LABEL_OFFSET</B>. </DD> <DT><STRONG><A NAME="tex2html433" HREF="../man/gmt_proj.c.html"><I><B>gmt_proj.c</B></I></A><A NAME="4259"></A></STRONG></DT> <DD>: Fixed bug in azimuthal equal area projection that had the horizon shifted from where it ought to be. Avoid error in <TT>GMT_lamb_sph</TT> when lat is 90 degrees. Clip path for general perspective projection was not closed. For <B>-JS</B>: Would set slice to NaN if central meridian was not Greenwich. For <B>-JR</B>: Longitudes beyond 180 were set to 180. </DD> <DT><STRONG><A NAME="tex2html434" HREF="../man/gmt_stat.c.html"><I><B>gmt_stat.c</B></I></A><A NAME="4267"></A></STRONG></DT> <DD>: Bug in <TT>GMT_median</TT> would sometime give subtle mistakes, most noticeable when only a few values were passed to the function. Traced to the use of <I>size_t</I> variables in expressions that could yield a negative value. Fixed minor issues in <TT>GMT_PvQv</TT> function. </DD> <DT><STRONG><A NAME="tex2html435" HREF="../man/gmt_support.c.html"><I><B>gmt_support.c</B></I></A><A NAME="4274"></A></STRONG></DT> <DD>: Made <TT>GMT_polygon_is_open</TT> tolerant of round-off and if polygon is not open set last to exactly equal first point. <TT>GMT_get_annot_label</TT> did not properly honor the <I>ddd.xx</I> setting. Now implements annotation for Gnomonic maps. In <TT>GMT_contour</TT>, would occasionally not check internal crossings for some interior contours. </DD> <DT><STRONG><A NAME="tex2html436" HREF="../man/pslib.c.html"><I><B>pslib.c</B></I></A><A NAME="4282"></A></STRONG></DT> <DD>: Bug in <TT>ps_shorten_path</TT> lead to SEGV when path resulted in a single point. Fixed error in applying <A NAME="tex2html437" HREF="../man/pstext.html"><I><B>pstext</B></I></A><A NAME="4288"></A>'s <B>-Dj</B><I>dx/dy</I> shift in paragraph mode (<B>-M</B>). Redefine rect symbol to be less prone to round-off. Used internal <I>point_code</I> before it was initialized. This caused <B>PAGE_COLOR</B> not to work (wrote <IMG WIDTH="16" HEIGHT="29" ALIGN="MIDDLE" BORDER="0" SRC="img13.png" ALT="$<$">NUL<IMG WIDTH="16" HEIGHT="29" ALIGN="MIDDLE" BORDER="0" SRC="img11.png" ALT="$>$"> rather than C). </DD> <DT><STRONG><A NAME="tex2html438" HREF="../man/gmtmath.c.html"><I><B>gmtmath.c</B></I></A><A NAME="4295"></A></STRONG></DT> <DD>: Implemented Welford (1962) algorithm in <B>KURT</B>, <B>SKEW</B> and <B>STD</B> operators for more precise one-pass computation of mean and sum of squares. </DD> <DT><STRONG><A NAME="tex2html439" HREF="../man/gmtselect.c.html"><I><B>gmtselect.c</B></I></A><A NAME="4300"></A></STRONG></DT> <DD>: The <B>-:o</B> option failed to reverse output order. </DD> <DT><STRONG><A NAME="tex2html440" HREF="../man/grd2xyz.c.html"><I><B>grd2xyz.c</B></I></A><A NAME="4306"></A></STRONG></DT> <DD>: Do not abort when <B>-R</B> exceeds grid; simply output common region. For gridline oriented grids: <B>-E</B> returned xll and yll one cell too large. Now writing [xy]llcenter properly. </DD> <DT><STRONG><A NAME="tex2html441" HREF="../man/grdblend.c.html"><I><B>grdblend.c</B></I></A><A NAME="4313"></A></STRONG></DT> <DD>: Did not pick up node registration before calculating output grid size. </DD> <DT><STRONG><A NAME="tex2html442" HREF="../man/grdedit.c.html"><I><B>grdedit.c</B></I></A><A NAME="4318"></A></STRONG></DT> <DD>: Adjust z_min and z_max when changing add_offset or scale_factor. </DD> <DT><STRONG><A NAME="tex2html443" HREF="../man/grdgradient.c.html"><I><B>grdgradient.c</B></I></A><A NAME="4323"></A></STRONG></DT> <DD>: With <B>-D</B> and <B>-S</B> the slopes were not set to NaN if data were NaN. </DD> <DT><STRONG><A NAME="tex2html444" HREF="../man/grdinfo.c.html"><I><B>grdinfo.c</B></I></A><A NAME="4330"></A></STRONG></DT> <DD>: Implemented Welford (1962) algorithm for more precise one-pass computation of mean and sum of squares. zmin==zmax no longer forces <B>-M</B> option. </DD> <DT><STRONG><A NAME="tex2html445" HREF="../man/grdmask.c.html"><I><B>grdmask.c</B></I></A><A NAME="4336"></A></STRONG></DT> <DD>: Tiny bug for determining which hemisphere (N/S) unlikely to have had any effect. Needed to allow for some slop when comparing shrink to 0.0 since sometimes the result of <I>acos</I> is 1e-14 or thereabouts. </DD> <DT><STRONG><A NAME="tex2html446" HREF="../man/grdmath.c.html"><I><B>grdmath.c</B></I></A><A NAME="4341"></A></STRONG></DT> <DD>: Implemented Welford (1962) algorithm in <B>KURT</B>, <B>SKEW</B> and <B>STD</B> operators for more precise one-pass computation of mean and sum of squares. </DD> <DT><STRONG><A NAME="tex2html447" HREF="../man/grdview.c.html"><I><B>grdview.c</B></I></A><A NAME="4346"></A></STRONG></DT> <DD>: The facade (<B>-N</B>) outline was drawn with contour pen. The <B>-Qc</B> option failed to set the ``build image'' flag and produced garbage surface tiles. Also, <B>-T</B>[<B>s</B>] produced polygons that were not checked for wrapping at a periodic map boundary. Clarified that <B>-T</B> cannot take <B>-JZ</B><IMG WIDTH="8" HEIGHT="31" ALIGN="MIDDLE" BORDER="0" SRC="img12.png" ALT="$\vert$"><B>z</B>. </DD> <DT><STRONG><A NAME="tex2html448" HREF="../man/minmax.c.html"><I><B>minmax.c</B></I></A><A NAME="4356"></A></STRONG></DT> <DD>: Could get confused when longitudes crossed dateline or Greenwich, and <B>OUTPUT_DEGREE_FORMAT</B> could interfere with result. </DD> <DT><STRONG><A NAME="tex2html449" HREF="../man/pscontour.c.html"><I><B>pscontour.c</B></I></A><A NAME="4361"></A></STRONG></DT> <DD>: <B>-T</B> option was susceptible to infinite loop if bad record was found. </DD> <DT><STRONG><A NAME="tex2html450" HREF="../man/pshistogram.c.html"><I><B>pshistogram.c</B></I></A><A NAME="4367"></A></STRONG></DT> <DD>: The <B>-R</B> option was processed separately and did not understand time coordinates. Bug in <B>-F</B> option failed to center bins. </DD> <DT><STRONG><A NAME="tex2html451" HREF="../man/psmask.c.html"><I><B>psmask.c</B></I></A><A NAME="4374"></A></STRONG></DT> <DD>: The <B>-D</B> option used the wrong output file name. </DD> <DT><STRONG><A NAME="tex2html452" HREF="../man/psscale.c.html"><I><B>psscale.c</B></I></A><A NAME="4380"></A></STRONG></DT> <DD>: Inverted vertical scale, when using filled rectangles: Colors remained in the original order. Inverted vertical or horizontal scale, when using rectangles with gradients: Size of rectangles followed original order, not inverted. In reverse mode, <B>-Eb</B> was plotting foreground triangle, <B>-Ef</B> background triangle. </DD> <DT><STRONG><A NAME="tex2html453" HREF="../man/pstext.c.html"><I><B>pstext.c</B></I></A><A NAME="4387"></A></STRONG></DT> <DD>: Parsing of <B>-C</B> complained about % sign. </DD> <DT><STRONG><A NAME="tex2html454" HREF="../man/psxy.c.html"><I><B>psxy.c</B></I></A><A NAME="4393"></A></STRONG></DT> <DD>: If first symbol in list with size was not circle, it got rejected. When sizes of <B>-Sr</B> or <B>-Sj</B> were read from list, they were always assumed to be in inches. Drawing arrows with <B>-SvS</B> and time-coordinates did not work as 2nd time coordinate did not get processed properly. </DD> <DT><STRONG><A NAME="tex2html455" HREF="../man/psxyz.c.html"><I><B>psxyz.c</B></I></A><A NAME="4401"></A></STRONG></DT> <DD>: If first symbol in list with size was not circle, it got rejected. When sizes of <B>-Sr</B> or <B>-Sj</B> were read from list, they were always assumed to be in inches. </DD> <DT><STRONG><A NAME="tex2html456" HREF="../man/sample1d.c.html"><I><B>sample1d.c</B></I></A><A NAME="4408"></A></STRONG></DT> <DD>: Calendar time knots did not get properly interpreted with <B>-N</B>. </DD> <DT><STRONG><A NAME="tex2html457" HREF="../man/mgg/mgd77togmt.c.html"><I><B>mgg/mgd77togmt.c</B></I></A><A NAME="4414"></A></STRONG></DT> <DD>: Did not initialize the MGG_SHAREDIR path. </DD> <DT><STRONG><A NAME="tex2html458" HREF="../man/mgd77/mgd77.c.html"><I><B>mgd77/mgd77.c</B></I></A><A NAME="4419"></A></STRONG></DT> <DD>: Wrong header order written if <A NAME="tex2html459" HREF="../man/mgd77convert.html"><I><B>mgd77convert</B></I></A><A NAME="4424"></A> ... <B>-Tt</B> was used. </DD> <DT><STRONG><A NAME="tex2html460" HREF="../man/mgd77/mgd77info.c.html"><I><B>mgd77/mgd77info.c</B></I></A><A NAME="4430"></A></STRONG></DT> <DD>: Could get confused when longitudes crossed dateline or Greenwich, and <B>OUTPUT_DEGREE_FORMAT</B> could interfere with result. </DD> <DT><STRONG><A NAME="tex2html461" HREF="../man/mgd77/mgd77sniffer.c.html"><I><B>mgd77/mgd77sniffer.c</B></I></A><A NAME="4435"></A></STRONG></DT> <DD>: Numerous fixes and enhancements; see ChangeLog. </DD> <DT><STRONG><A NAME="tex2html462" HREF="../man/x2sys/x2sys.c.html"><I><B>x2sys/x2sys.c</B></I></A><A NAME="4440"></A></STRONG></DT> <DD>: Error in determining which columns had been requested. </DD> <DT><STRONG><A NAME="tex2html463" HREF="../man/x2sys/x2sys_binlist.c.html"><I><B>x2sys/x2sys_binlist.c</B></I></A><A NAME="4445"></A></STRONG></DT> <DD>: Could create bad bins because of incorrect reallocation of memory. </DD> <DT><STRONG><A NAME="tex2html464" HREF="../man/x2sys/x2sys_get.c.html"><I><B>x2sys/x2sys_get.c</B></I></A><A NAME="4450"></A></STRONG></DT> <DD>: The <B>-L</B> option did not honor any <B>-F</B> or <B>-N</B> settings. </DD> <DT><STRONG><A NAME="tex2html465" HREF="../man/x2sys/x2sys_put.c.html"><I><B>x2sys/x2sys_put.c</B></I></A><A NAME="4458"></A></STRONG></DT> <DD>: Wrong test when replacing older track info lead to data base loss. </DD> <DT><STRONG><A NAME="tex2html466" HREF="../man/x2sys/x2sys_cross.c.html"><I><B>x2sys/x2sys_cross.c</B></I></A><A NAME="4463"></A></STRONG></DT> <DD>: Used wrong data column order and computed speed when there is no time. <P> </DD> </DL> <P> <HR> <!--Navigation Panel--> <A NAME="tex2html2688" HREF="node17.html"> <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> <A NAME="tex2html2682" HREF="node10.html"> <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> <A NAME="tex2html2676" HREF="node15.html"> <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> <A NAME="tex2html2684" HREF="node1.html"> <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> <A NAME="tex2html2686" HREF="node255.html"> <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> <BR> <B> Next:</B> <A NAME="tex2html2689" HREF="node17.html">1.1.7 Overview of GMT</A> <B> Up:</B> <A NAME="tex2html2683" HREF="node10.html">1.1 What is new</A> <B> Previous:</B> <A NAME="tex2html2677" HREF="node15.html">1.1.5 Overview of GMT</A> <B> <A NAME="tex2html2685" HREF="node1.html">Contents</A></B> <B> <A NAME="tex2html2687" HREF="node255.html">Index</A></B> <!--End of Navigation Panel--> <ADDRESS> Paul Wessel 2010-01-14 </ADDRESS> </BODY> </HTML>
