Please report bugs and change requests to Francis Vitt - email: fvitt@ucar.edu Version 4.7h -- 17 Apr 2006 * Fixed a bug in geov_multifiles__define::get_data which occurred when a subset of time records was extracted from multiple files. Version 4.7g -- 07 Mar 2006 * Changed P0 to 100000 from 101300 in procedure gnc_get_pressure_coor which recalculates the pressure levels. This was causing a lot of confusion when the new pressures did not match the coordinate values in the netCDF file. Version 4.7f -- 06 Feb 2006 * Changed how year zero is handled. Year 0000 is set to -1 for Gregorian calendar. Year 0000 is labeled as -1 for all calendars. This change allows the user to open multiple files which span year 0000 to year 0001. * Added ability to handle netCDF files which do not have a time dimension. Version 4.7e -- 31 Aug 2005 * Added the option to dump the plotted data to netCDF. Version 4.7d -- 19 May 2005 * Broke out the overplot operator to a separate button so that one can over plot over plot data that has been operated on, e.g. smoothed. * Enabled the density type extractors (number and column densities) to work with zonal averaged data sets. Version 4.7c -- 11 May 2005 * Added global average options to 1D and 2D plot menus for netCDF data files that do not have a longitude dimension. It is assumed that the data has been zonally averaged and geov only needs to compute the latitude-weighted average to determine the global average. * Added "Smooth" option to the operators. This smooths the data in the time dimension. The use supplies the averaging window width via a pop-up dialog. This is applied only to time plots. Version 4.7b -- 06 May 2005 * The "absolute" time axis type now gives more time ticks and more meaningful tick labels. * Changed the time is handled. A new class, named nctime, has been added to interpret the time coordinate. This provides methods to create time stamps for the gui and time tick values/names for time axis. Version 4.7a -- 14 Apr 2005 * Added global average options to 1D and 2D plot menus. The global mean is computed by calculating the cosine(latitude)-weighted average of zonal average. * Fixed a bug in the "Levels Altitudes" button functionality which occurred when multiple plot windows were used. Version 4.6t -- 21 Mar 2005 * Fixed the following bug. Over-plotting of ozone data converted to Dobson units was plotted in units in the netCDF file without being converted to Dobson units. * Fixed the following bug. If you have two (or more files) open and you do line plots, the line color changes to red in all windows when you switch focus (click) from one window to another. This happens even if you're not over plotting or otherwise actively comparing results across windows. * Relaxed the strict requirement of data all data fields needing to have the same units for the summation extractor. Now the user gets a message dialog if the units don't match. Version 4.6s -- 14 Mar 2005 * Fixed bug in col density extractor. The time offsets were incorrectly assumed to start at zero in int_col_dens routine. Version 4.6r -- 8 Feb 2005 * Added "Trop. Col." extractor. This extractor computes the column density by integrating over levels from surface to the tropopause. The variable TROPLEV must be included in the data file. This is the height of the tropopause from surface in km. * Added auto_window_raise flag to Geov_preferences. This can be set to zero if the user does not want Geov to automatically bring windows to foreground. * Fixed a bug in wind vector overlays. The wind data was not being shifted wind the plot data when 'Atlantic' map was selected. Version 4.6q -- 7 Jan 2004 * Added ability to select log scaling on 1-D plots by selecting the "log" option under "Display Options:". * The linear scaling of the contour levels now produced evenly spaced levels in all cases, including when the field spans across zero. * The summation extract settings are now persistent. That is, it remembers its latest settings so that when one selects another time or another data slice one does not have to reenter the settings. * The summation extractor now works with the operators. * The density extractor now works with any field if the field does not have mix ratio units than the extracted field is the selected field times the background density. * The scale height is now set to 7.0 km. Version 4.6p -- 9 Dec 2004 * Moved "Density", "Total Col", "Col Above", and "Sum" options from the "Operator" menu to a new menu named "Extractor". Now one can clearly select an extractor type to be used by a plotter and preform an operation on the extracted data. * Fixed the following bug introduced in version 6o: Zooming when in "1D PLOT" zooms in correctly, but the following cryptic message appears: "ERROR: Variable is undefined: SUCCESS". * Fixed the following bug for 1D PLOT : Time series, zonal average" does not work when Operator is set to "Total Col." In other words, one cannot get the time evolution of zonal mean ozone column at a single latitude. Program fails with error message: "REFORM: New subscripts must not change the number of elements in INT_COL" * Fixed the following bug: "Level altitudes" button changes pressure scale to altitude scale. However, it does not retain the memory of this choice if, for whatever reason the plot is refreshed (e.g., if one switches to plotting a different field, or even if one clicks on the current plot to select a particular location, the vertical scale reverts to pressure). * "Automatic Contour Levels : linear" now produces an equally-spaced linear scale across the range of values in a contour plot. * Changed the default color table so that no two contour levels have exactly the same color * Fixed the "Sum..." extractor. * Changed the definitions for window sizes in file /geov/geov_preferences/geov_preferences__define.pro Version 4.6o -- 1 Dec 2004 * Fixed bug in number density operator which occurred when one selected some of the plot configurations such as meridian slice. * Fixed bug in how data is concatenated from multiple files. * Made changes to zoomer so that when the zoom box is too small is is treated as a mouse button press and release event. This is in response to a complaint that sometimes a button press and release action gives an error message when the mouse moves slightly between the press and release. Version 4.6m -- 09 Aug 2004 * Made time interpretation more robust. Now able to use time variable which is a char type. Also able to use date and datetime variables when time variable is not included in netCDF file. Now able to use index data for dimensions when dimension variable is not in data file. Version 4.6l -- 09 Jul 2004 * Fixed a bug in vertical plots that occurred when interface levels in the data file are in units of "levels". This was solved by computing the hybrid pressure level values for the interface levels in the same fashion they are computed for the mid point levels in the file geov_ncfile__custom.pro. Version 4.6k -- 07 Jul 2004 * Martin Schultz - new geov_ncfile__custom.pro which now allows for cases when the time variable has no attributes. Version 4.6j -- 24 May 2004 * Fixed a bug which was introduced in version 4.6f. If netCDF file did not include levels, i.e., the data is independent of vertical dimension, the activator tried to update the levels list to the interface data, which caused an error. Version 4.6i -- 14 May 2004 * Add ability to operator on two different data sets which have different resolutions. Data set "B" is interpolated to the resolution of data set "A". (Including user defined operator) Version 4.6h -- 11 May 2004 * Fixed a bug which was introduced in version 4.6f. If files does not include interface levels dimension geov will now plot the data. Version 4.6g -- 10 May 2004 * Corrected bug in over plotting of 1-D line plots of data sets of different resolutions. * Corrected bug in over plotting of contour plots of data sets of different resolutions. Version 4.6f 30-Apr-2004 * Added the ability to plot variables which have the level interfaces as the vertical dimension in addition to variable which have the level midpoints as the vertical dimension, i.e., ilev in addition to lev. * Fixed a bug which was introduced with IDL version 6.0 in the toggling of the extra controls widget (Hide or Show Extra Controls button). Version 4.6e * Fixed problem where Geov runs out of memory when one plots zonal average total column vs time with a large number of time records. Version 4.6d * Fixed bug in the wind overplot function which occurs when magnitude of the horizontal wind is exactly zero (24 Feb 2004). * Corrected another error in how arrays are concatenated from multiple files Version 4.6b * Corrected an error in how arrays are concatenated from multiple files Version 4.5o * Corrected error in how timestamps are determine in the case that the times are greater than one year past the reference time. Version 4.5n * The ability to overlay density and total column plots has been added. If the last operator is one of the density operators then data used in the overplot is the density. Version 4.5m * The control widgets placed below the coordinate lists on the control panel can be hidden to make the control panel smaller. These controls are not hidden when the control panel is initially shown. To hide or show these controls, select "Hide Extra Controls" or "Show Extra Controls" menu option under the "CONTROLS" menu. * Added the following menu options to the "FILE" menu: o "Open..." - brings the file manager window to the front so the one can easily select a directory to open another file o "Quit Geov" - closes all the Geov windows * Fixed bug in activation of 1D plotting options which occurred for certain scenarios Version 4.5l * Corrected the max and min values displayed for 2D uniform field * Changed number of characters lat/lon lists will display * Focus is given to plot window and brought to foreground when the plot is updated Version 4.5k1: changes by mgs 28 Mar 2003: * Added plot?d_position, ps_landscape, and charsize options to geov_preferences * Window_size now either a string (as before) or a pair of values indicating the fraction of the screen size to be used. * Renamed plot_position (for 2D plots) to plot2d_position files affected: ./geov/geov_preferences ./geov/geov_preferences/geov_preferences__define.pro ./geov/geov_preferences/geov_preferences__init.pro ./geov/geov_plotter ./geov/geov_plotter/geov_plotter__build_gui.pro ./geov/geov_plotter/geov_plotter__define.pro ./geov/geov_plotter/geov_plotter__plot2d.pro ./geov/geov_plotter/geov_plotter__setup_params.pro ./geov/geov_manager ./geov/geov_manager/geov_manager__create_plotter.pro ./geov/geov_manager/geov_manager__event_listener.pro ./geov/geov_gui ./geov/geov_gui/geov_gui__event_listener.pro ./geov_preferences.pro Version 4.5k * Fixed bug in 1-D time series over-plots * Fixed bug in truncation of time series plots of hourly data * Changes were made in the total column routines to make geov compatable with ECHAM files * Fixed a bug in summation operator. Version 4.5j * Added the ability to compute column density above the currently selected level. Added the the operators are "Total Col." and "Col. Above". "Total Col." computes the column density by integrating over all pressure levels. "Col. Above" computes the column density by integrating from the currently selected pressure through the top level. Version 4.5i * Column and density calculations now accept "m3/m3" units which are used in WACOM output files * Smoothly able to open MOZART 'one-column' files * Added ability to open MOZART emissions files * Contour plotting now uses +/- max float for the top and bottom levels - previously it was using +/- Infinity which did not give accurate plots on some machines * Corrected a bug in how arrays are concatenated when extracting data from multiple files. Version 4.5h * The total column and density operators are now more efficient. * Changed the number of log-pressure labels shown for 2D plots where levels is y-axis coordinate. Previously there where too many log-press labels and thus was unreadable. * Fixed following bugs in manual contour level setting dialog. - The last contour option is now remembered. - Contour levels set with option 4 are now correctly remembered if they are overwritten * A default calendar has been added for case where the calendar is not specified in the data file. The user can set the default calendar in geov_preferences.pro file. * Users now have a method to abort the construction of animations. A pop up window which contains a progress bar and a "cancel build" button appears when the animate function has been invoked. The progress bar shows the progress of the construction of the animation frames. * Over plot labels for scaled quantities (i.e., ppb, bbt, etc.) are now correct * Log-P option button has been renamed to "Level altitudes" * Problem labeling of the time axis has been solved. Version 4.5g * Start Geov in one of the following ways: a) type "idl geov" at the unix prompt b) type "igeov" at the IDL prompt c) type "@geov" at the IDL prompt * Added ability to compute summations of fields. In the "OPERATORS" drop down list select "sum..." option. Follow the instructions in the dialog. * Updated the information displayed in the "about Geov" window. * Removed the setting to 8 bit color on unix systems - if colors don't work on your system this should be set in the idlstarup file. * Added dummy directory to the archive manager which is overwritten with the path of the last directory visited * Added a note to the archive manager to remind users of the option to open more than one file * Corrected the format overflow problem which sometimes occurs in the levels data * Made time-labeling routine more robust for cases where the calendar attribute is not in the netCDF file * Added the option to select "Absolute" or "Relative" time axis for time plots. Under the "Displays" option select "Time Axis Type", then "Relative" or "Absolute" * Corrected the spelling of "Total Col" operator. * Added switch labeled "Oplot Same Scale". When selected this option causes overplots to use the same axis scales. Otherwise independent scales are used. * The longitude labels on polar plot did not look nice and were removed. - may need to manually draw the longitude labels outside the circle. * Made the density and total column routines more robust to work with ECHAM files. Version 4.5f * Relaxed the restriction that time steps must be consecutive. 01/24/2003b: MGS - level coordinates now translated into pressure if hyam and hybm are defined - error message displayed when associated coordinate not found modified routines: ./geov/geov_ncfile/geov_ncfile__custom.pro ./geov/geov_ncfile/geov_ncfile__init.pro ./geov/geov_plotter/geov_plotter__operate_data.pro ./geov/geov_plotter/geov_plotter__setup_params.pro ./nclib/nccoordfile/nccoord_pars.pro 01/24/2003a: MGS - last visited directory now automatically added to archive manager - little cleanup of cordinate handling for level units modified routines: ./geov/geov_ncfile/geov_ncfile__custom.pro ./geov/geov_ncfile/geov_ncfile__find_coord.pro ./geov/geov_ncfile/geov_ncfile__define.pro ./geov/geov_plotter/geov_plotter__build_gui.pro ./geov/geov_plotter/geov_plotter__plot2d.pro ./geov/geov_plotter/geov_plotter__operate_data.pro ./geov/geov_gui/geov_gui__init.pro ./geov/geov_manager/geov_manager__init.pro ./geov/geov_pars.pro ./guilib/archive_manager/archive_manager__get_data_dirs.pro ./guilib/archive_manager/archive_manager__build_gui.pro ./guilib/archive_manager/archive_manager__define.pro ./guilib/archive_manager/archive_manager__get_last_dir_wid.pro ./nclib/nccoordfile/nccoord_pars.pro ./utils/ncdf_timelabel.pro ./utils/mycolorbar.pro new routines: ./guilib/archive_manager/archive_manager__get_data_dirs.pro ./guilib/archive_manager/archive_manager__get_last_dir_wid.pro Version 4.5e changes: * Fixed date bug - for times based on a 365-day calendar geov was giving the wrong date * Fixed bug in time labels for time plots where the range in time is less than 2 days Version 4.5d changes: * Added the ability to open more than one file simultaneously with one control panel. The files opened simultaneously must meat the following criteria: - the time dimension must run consecutive from one file the the next - the file names must be ordered alphabetically according to time - the files must contain identical variables and coordinates * Plot windows are labeled as 'p', 'q', 'r', etc. These labels coorespond to the operands that are used in the "user defined" operator. For example, if the user wanted to add the fields shown in windows 'p' and 'q' the user would enter "p + q". * Total Column densities of O3 and OX are displayed in Dobson Units (DU). 1 DU = 2.687e16 molecules/cm^2 Version 4.5c changes: * Allow the user to open more than two control panels and plot windows simultaneously (upto 4 total). This may be confusing to the user as to which operands correspond to 'A' and 'B' for the binary operators. * Added ability to select colors used for line plots. In the "Display" menu select "Colors" then select "Select Drawing Colors...". This allows the user to select colors for the titles, contours, etc., including colors used for the line plots and the overplotting line plots. Version 4.5b changes: Bug fixes: * Labeling of the time axes is now standardized for all time scales. The axis is now labeled as some number of units since the start time/date. The units chosen is based on the time scale of the time series. * Latitude/Longitude labels are added to polar map plots. * Bug in Scale to ppm, etc is corrected. Enhancements/Changes: * Options for the Automatic Contouring have been added. The options added are as follows: "auto" - allow the gui to choose log or linear scale "log" - force the gui to use a log scale "linear" - force the gui to use a linear scale * Option added to allow the user to select the format used on the labels for the color scale bar. This option is found in the "Display" menu. * Option to add/remove filename and timedate stamps at the bottom of plotting window has been added. This option can be found on the "Edit Plot Titles" dialog found in the Display menu. * Overplot operator now uses the contour levels of the underlaying data for the contour levels of the overplotted data. Version 4.5a changes: * Run Geov by typing "geov" at the IDL prompt - previously, one had to type "@geov". BUG FIXES: * The user no longer needs to reposition the newly created windows to make them active in the linux environment. * Rate of the animation is now initialize to a low setting. * After viewing an animation the control panel now returns the time step selection back to the original setting. * As one moves from one plotting window to another, the sensitivities of the lists in the control panel change appropriately according the dimensions of the data displayed in the plotting windows. * Corrected problem with the tick marks on 2D plot with log-pressure on left and height (km) on the right. The tick marks for the log-pressure were being drawn both sides of the plot causing extra tick marks on the right side of the plot where the height tick mark were drawn. * Corrected inverse of zero problem in the 1/A operator. FEATURES ADDED/CHANGED * Over plot operator for the 1D plot now uses equal plotting ranges for both data sets. * Number density operator has been added. This computes the number density (#/cm^3) from the VMR being viewed. * Total column density operator has been added. This computes the total column (#/cm^2) from the VMR being viewed. * User defined operator. Now one is able to input an operator using IDL syntax with the data sets to be operated on as "A" and "B" in the expression. 08/15/2002: MGS - fixed bug in bug fix ;-( 08/14/2002: MGS - fixed bug causing inability to read 2D fields when wind data is present in data file 07/10/2002: MGS - remodeled timestamp format, now uses new utility routine ncdf_timelabel (new entry dateformat in geov_preferences.pro) - removed verbose attribute in heap_gc (geov_plotter) - set system variable !QUIET per default to 1, so that '% compiled ...' does not show 06/21/2002: MGS - version consolidation; added mising utils routines - default data_dirs now dependend on OS and always include current - added default map type to preferences and changed default plot to MAP - added contour_opt default to preferences - default colors for 1D plots changed from yellow, blue to blue, red - for LON/LAT and map plots, title now displays either 'hPa' or 'km' depending on status of 'Log-P levels' button - introduced more fancy axis labeling for logarithmic y axis 06/13/2002: MGS - added "animation to file" button and possibility to interrupt animation buildup. modified routines: ./geov/geov_plotter/geov_plotter__animate.pro ./geov/geov_plotter/geov_plotter__plot2d.pro ./geov/geov_gui/geov_gui__define.pro ./geov/geov_gui/geov_gui__event_listener.pro ./geov/geov_gui/geov_gui__build_gui.pro ./geov/geov_gui/geov_gui__activator.pro - changed automatic scaling of vmr to fixed scale factors. modified routines: ./geov/geov_plotter/geov_plotter__init.pro ./geov/geov_plotter/geov_plotter__operate_data.pro ./geov/geov_plotter/geov_plotter__scale_data.pro ./geov/geov_plotter/geov_plotter__set.pro ./geov/geov_gui/geov_gui__event_listener.pro ./geov/geov_gui/geov_gui__build_gui.pro ./geov/geov_extractor/geov_extractor__init.pro 05/27/2002: MGS - fixed bug in reading time information from netcdf file 04/30/2002: MGS - fused radio buttons for automatic and fixed contour levels into one checkbox 'automatic' - changed png output to come out upside up (removed flip operation) - deactivated colorbar for monochrome line plots - reworked handling of drawing colors: now stores color names in plotter object and uses David Fanning's fsc_color routine to load these colors into the color table. Added "Select drawing colors ..." menu entry and uses mgs_drawcolors object for color selection of background, titles, contour lines, continents, grid lines, ... This was another major change affecting the following files: ./geov/geov_pars.pro ./geov/geov_plotter/geov_plotter__animate.pro ./geov/geov_plotter/geov_plotter__define.pro ./geov/geov_plotter/geov_plotter__plot1d.pro ./geov/geov_plotter/geov_plotter__get.pro ./geov/geov_plotter/geov_plotter__import.pro ./geov/geov_plotter/geov_plotter__init.pro ./geov/geov_plotter/geov_plotter__plot.pro ./geov/geov_plotter/geov_plotter__setup_params.pro ./geov/geov_plotter/geov_plotter__set.pro ./geov/geov_plotter/geov_plotter_contour_manager ./geov/geov_plotter/geov_plotter_contour_manager/geov_plotter_contour_manager__export.pro ./geov/geov_plotter/geov_plotter__plot2d.pro ./geov/geov_gui/geov_gui__define.pro ./geov/geov_gui/geov_gui__event_listener.pro ./geov/geov_gui/geov_gui__build_gui.pro ./geov/geov_gui/geov_gui__get.pro ./geov/geov_gui/geov_gui__set.pro ./geov/geov_gui/geov_gui__import.pro ./geov/geov_gui/geov_gui__activator.pro 04/23/2002: MGS - attempted to have the 'option' value of the contour level manager remembered. Turns out to be more complicated than I thought because import is done from plotter while export is done to gui. Is there a reson for this?? - added a 4th option to the contour level manager to allow user to specify specific values and a scale factor. Not quite completed, because gui updating needs overhaul, but works... 04/22/2002: MGS - added wind vector capability. This was a major change involving the following routines: ./geov/geov_ncfile/geov_ncfile__get.pro ./geov/geov_ncfile/geov_ncfile__define.pro ./geov/geov_ncfile/geov_ncfile__init.pro ./geov/geov_ncfile/geov_ncfile__find_uv.pro (NEW ROUTINE) ./geov/geov_plotter/geov_plotter__define.pro ./geov/geov_plotter/geov_plotter__init.pro ./geov/geov_plotter/geov_plotter__operate_data.pro ./geov/geov_plotter/geov_plotter__set.pro ./geov/geov_plotter/geov_plotter__plot2d.pro ./geov/geov_gui/geov_gui__define.pro ./geov/geov_gui/geov_gui__event_listener.pro ./geov/geov_gui/geov_gui__build_gui.pro ./geov/geov_gui/geov_gui__activator.pro ./geov/geov_extractor/geov_extractor__define.pro ./geov/geov_extractor/geov_extractor__get.pro ./geov/geov_extractor/geov_extractor__extract_data.pro ./nclib/nccoordfile/nccoordfile__init.pro ./utils/msvelovect.pro (NEW ROUTINE) 04/21/2002: MGS - bug fix in gui__build_gui: program crashed when data file does not contain time variable. - bug fix in filled color contour : colors were shifted by 1, because -Inf was not recognized as lowest level. Now temporarily set to -9.99e30. - IDENTIFIED BUG in Atlantic view (and possibly elsewhere): extracted data is shifted by 1 grid box to the right, i.e. data is assigned to wrong lon coordinate. Couldn't find a solution so far!!! (geov_plotter/geov_plotter__plot2d.pro -- plot2d_prepare_data) - Changed default in GUI to lowest level, i.e. maximum value if data in pressure coordinates 04/15/2002: MGS - bug fix for date readin. If only date is found, but not datesec, geov now sets secs automatically to zero. 04/05/2002: MGS - fixed minor bugs from last updates (level unit km instead of hPa, etc.) - improved startup by using new geov_init procedure (allows auto-detection of parentdir) - changed data archive manager to allow only one instance ("singleton object") - added Quit GEOV button to data archive manager - added resizing functionality for plotter windows - fixed pressure to altitude conversion: use maximum pressure instead of fixed P0 - bug fix for vertical slice plots: right axis was drawn twice