This is the Ocean Data View (mp) development history file. © 2006 R. Schlitzer, Alfred Wegener Institute for Polar and Marine Research, Bremerhaven, Germany Email: rschlitzer@awi-bremerhaven.de ----------------------------------------------------------------------- NOTE: If you use Ocean Data View for your scientific work, you must reference it in your publications as follows: Schlitzer, R., Ocean Data View, http://odv.awi-bremerhaven.de, 2006. COMMERCIAL USE: If you plan to use Ocean Data View or any of its components for commercial and/or military applications and products, you need to obtain a software license. Please contact the address above for further information. ----------------------------------------------------------------------- ODV(mp) Release 3.0.4 Feb/15/2006: BUG FIXES -- switching from STATION mode to SURFACE mode (and possibly other modes) would occasionally crash ODV. ODV(mp) Release 3.0.3 Jan/12/2006: BUG FIXES -- ODV no longer crashes when encountering variable labels longer than 60 characters in import files. ODV(mp) Release 3.0.2 Nov/15/2005: BUG FIXES -- Mollweide coordinate projections/unprojections now much more accurate. this now allows reliable definitions of sections, lines and polygons in Mollweide maps. -- subsetting of primary coordinate in netcdf emulation now supported. automatic subsetting enforced if primary coordinate is longer than 20,000. previous array overruns for stations with more than 100,000 data values now prevented. -- fixes a bug when selecting the primary coordinate during definition of a netcdf emulation. -- fixes a bug when using derived variables in isosurface variables definitions (netcdf files only). -- various bugs in ARGO trajectory file import routine fixed. ODV(mp) Release 3.0.1 Aug/23/2005: GUI CHANGES -- the font-size of axis labels and text annotations can now also be adjusted for the map. the font-size scale factor is available on the map Display Option dialog. DERIVED VARIABLES -- safeguarded calculation of logarithm "ln" and square-root "sqrt" in Expressions or Macros. zero or negative arguments are detected and the missing value indicator is returned as result. -- iso-surface variable calculation for TOP and BOTTOM will now use first or last sample that contains data for the requested variable GRAPHICS OBJECTS -- new "CDT-File" graphics object lets you add polygon or polyline features to the map or any Longitude/Latitude window. all coastline, bathymetry, topography or general overlay cdt files can be used as CDT-File objects. IMPORT/EXPORT -- ODV now handles two additional date formats MMDDYYYY and DDMMYYYY (e.g., 12272001 or 27122001) in import files. appropriate conversions to the internal date format can be selected during header variable association. BUG FIXES -- fixes filename bug when importing ARGO v2.1 profile and trajectory files. -- when exporting the contour lines of a map to a .gob file, the X/Y coordinates are now properly unprojected. -- now correctly reads numerical values from NC_CHAR attributes in netcdf files. ODV(mp) Release 3.0 May/17/2005: GUI CHANGES -- switching between MAP, STATION, SCATTER, SECTION, and SURFACE modes is now via tabs in the lower left part of the graphics canvas or by pressing the F8 ... F12 keys. the "Use Template" options of the Configuration and canvas popup menus are no longer available. -- on the windows layout menu (invoke option "Configuration>Window Layout" or "Window Layout" from the canvas popup menu, then right-click the mouse) ODV now offers various layout templates. ODV now lets you specify window display options and color properties while in window layout mode (this saves some plot window redraws). -- shortcut key for redrawing canvas, map and/or data plots changed to F5 from "r". -- when the mouse is over a data plot window, pressing F4 will now bring up the statistics information dialog. -- new option "Auto Zoom In" on map and data plot popup menus automatically zooms into area around current mouse position. this option can also be invoked by pressing Alt-Z. -- the font-size of axis labels, text annotations and contour line labels can now be adjusted for each data plot seperately. the font-size scale factor is available on the Display Option dialog. DERIVED VARIABLES -- calculation of pH and carbon system parameters now uses equilibrium constants from Dickson and Goyet, DOE Handbook, Version 2, 1994 (K1, K2 from Roy et al., 1993; KB from Dickson 1990; KS from Dickson&Riley 1979; KW from Millero, 1995). the pressure effect on equilibrium constants is now included. ODV versions 2.1 and later calculate in-situ pH and carbon system parameters, whereas previous ODV versions calculated "potential" pH and and carbon system parameters, e.g., the values a water parcel would have if raised to the surface adiabatically. ODV results have been cross-checked against output from the CO2SYS.EXE application of Lewis&Wallace (1998). -- new derived variables CO2 Fugacity (fCO2), Revelle Factor and solubility ratios OmegaC and OmegaA for calcite and aragonite. -- derived variables that previously required Depth as input variable can now also be defined with Pressure. if you have pressure as primary coordinate of your station data, you can define potential temperature, potential density and many other variables without having to define Depth(Press) first. -- atmospheric trace gas database updated until 2004 (used for partial pressure and age calculations). GRAPHICS OBJECTS -- new option "Manage Graphics Objects" on Extras sub-menu of the canvas, map and data plot popup menus allows edit, export, re-ordering and deletion of canvas, map and data plot graphics objects. -- new option "Export as Graphics Object" on Extras sub-menu of the map and data plot popup menus now allows to export the map's station selection polygon (if any), the data plot's colored dots, contour lines and/or section bathymetry polygons to graphics object files. These objects can then be added to other windows using "Add Graphics Object>Import from File...". -- graphics objects can now be copied via the new Copy Object option on "Graphics Object" context menu or the "Manage Graphics Objects" option. -- ODV annotations may now contain text substitution functions for date, time and other dynamic information. See chapter 15.7 in the User's Guide for more information. IMPORT/EXPORT -- new import options for Argo float profile and trajectory data (single or multiple file(s); GDAC netcdf 2.1 format, as available from Coriolis and GODAE data centers) -- required labels for longitude and latitude columns in generic ODV spreadsheet files changed to "Longitude [degrees_east]" and "Latitude [degrees_north]", respectively. The previously recommended labels "Lon (°E)" and "Lat (°N)" are still supported for backward compatibility. -- ODV now supports a more compact spreadsheet file format (generic and general; import and export), where the station header information is only required for the first sample of a station. on subsequent lines for the same station, the header columns may remain empty (ODV automatically uses the last ones specified in the file). note that the column separation characters for the header variables are still required on all lines, e.g., the number of columns must still be the same on all lines. -- new option Export>Iso-surface Variables lets you export all iso-surface values to a single spreadsheet file. -- spreadsheet files can now have more than 99 comment lines at beginning of file. MISCELLANEOUS -- improved gridding and visualization algorithm for sparse and very heterogenous data coverage. -- poorly sampled profiles now detected more reliably during iso-surface variable calculation. -- option Utilities>Find Outliers now lets you search for values inside a given range as well as outside the range. -- station marks in map can now have different colors for different cruises. to activate this feature, choose (automatic) as "Station Dot Color" on the map Display Options dialog. -- in data windows with gridded fields you can now choose (automatic) for the color of data marks. odv will then use colors depending on the Z value of the data points (you should use large values for Size to obtain large dots). -- Edit Data option now also available in SURFACE mode -- isopycnals can now also be requested in SURFACE mode theta/S plots -- collection names may now contain periods ".", e.g., "GLODAP-v1.1_bottle" is now a valid collection name BUG FIXES -- import of graphics objects "Import from File.." would only import first item from a multi-item .gob file. -- File>Open would fail on *.cdf *.csv *.jos *.o4x and *.zip files -- missing column separators fixed in clipboard copy output. -- now properly handles the following situations in WOCE WHP exchange files: (1) long SECT_ID and EXPOCODE, (2) 3-digit TIME entries, (3) missing END_DATA line. -- fixed various bugs with graphics objects. -- MAC: file-open and file-save dialogs now properly honor initial directories. now properly receive input focus, when triggered from dialog boxes (derived variables "Difference from Reference" and "Macro File"). ODV(mp) Release 2.0 April/26/2004: -- several menu options have been added, renamed and/or moved (within the same menu or to different menu locations; important changes are listed below). odv 1.4 odv 2.0 ------------------------------------------------------------------- Bckgrd Menu>... Mode Bckgrd Menu>Use Template>... File>Open Collection File>Open (select file type: Collection Files) File>Open Open netCDF File File>Open (select file type: netCDF Files) Data Plot Menu>Extras>Custom Estimation Data Plot Menu>Extras>2D Estimation Utilities>Temporal Distribution Map Menu>Extras>Temporal Distribution Utilities>Data Retrieval Utilities>Box Averaging ---- Utilities>3D Estimation Utilities>Define as Reference Export>X/Y/Z Data as Reference Export>Export Plot Values Export>X/Y/Z Data -- support for command line options has been improved. netcdf and supported import files can now be accessed remotely. see chapter 2.3 of the ODV User's Guide for more details. -- support for netcdf files has been improved considerably. data access is now much faster, and a new netcdf emulation wizard facilitates the selection and subsetting of variables. visual domain subsetting by zooming into a map is now possible. -- the calculation of iso-surface variables from netcdf files is now much faster. if the iso-surface coincides with one of the grid levels in the netcdf file, values are taken directly from the nc file. -- the netcdf default missing value indicators NC_FILL_BYTE, NC_FILL_SHORT, NC_FILL_INT, NC_FILL_FLOAT, NC_FILL_DOUBLE, nf_fill_byte, nf_fill_short, nf_fill_int, nf_fill_float, nf_fill_double are now automatically detected and removed. -- ODV now lets you produce animated GIF files for the map or any data plot window. To produce an animation, right-click on the respective window and choose one of the options Extras>Animation>Header Time, Ex-tras>Animation>Validate Variable, or Extras>Animation>Isosurface. see chapter 17.11 in the ODV Users Guide for more information. -- new option "Utilities>3D Estimation" allows estimation of Z-values at arbitrary, user-specified lon/lat/depth points (read from file). See help file chapter 15.3 for more details. -- the Extras>Statistics option is now available also for the station map, in addition to the data plot windows. it now also provides distribution histograms of the X, Y or Z data, plots of the data distribution in X/Y space, and allows to export the statistics information to the clipboard. -- ODV supported data files (e.g., ODV and Java Ocean Atlas spreadsheet files, WOCE WHP exchange files, .o4x files, etc.) can now be opened directly via the new File>Open option. Choose file-types "Data Files (*.txt *.csv *.jos *.o4x)" or "All Files (*.*)". ODV will automatically create and open a collection based on the data in the file. -- ODV spreadsheet files (generic and general) can now have comment lines at arbitrary positions in the file. you use two slashes // as first two characters to indicate a comment. comments are written to the collection info file during import. multiple missing value indicators in import files now supported, e.g., -999 and -9 and -999.9, ... can all be identified and handled properly. -- you can now drag-and-drop any file onto the ODV icon or window. for unrecognized file types ODV will attempt a spreadsheet import. -- when creating new collections via File>New and using a .txt file as template for the definition of collection variables, the ODV generic header labels "Cruise", "Station", "Type", "mon/day/yr", "hh:mm", "Lon (°E)", "Lat (°N)", and "Bot. Depth [m]" are now automatically detected (case insensitive search) and excluded from the list of initial collection variables. -- sample quality filters Good, Unknown, Questionable, and Bad can now be selected/unselected independently. -- the Edit Data option is now available also for variables for which currently no data values are stored in the collection. this is useful for manually adding data values for new variables. -- ODV now checks the syntax of expressions and macros and identifies syntax errors. execution of macros is now much faster due to internal command compilation. you can now edit ODV macros and expressions through the Derived Variables option from the background popup menu. then select the respective variable in the Already Defined list box and press Edit. expressions can now be saved in macro files. new %H topographic height variable. -- when creating an overlay window (Window Layout mode), ODV lets you automatically choose a Z-variable and will automatically setup default isolines. Z-variable annotations no longer overlap. -- when defining a section with Define Section Spine the map is now temporarily resized to full-page for easier definition of the section spine. -- previous ETOPO support for section-bathymetry replaced by more accurate and higher resolution GEBCO1 and ETOPO2 data. install one of the new optional packages "odvmpOP_GEBCO1_12m_...", "odvmpOP_ETOPO2_12m_..." (12'x12' resolution) or "odvmpOP_GEBCO1_6m_...", "odvmpOP_ETOPO2_6m_..." (6'x6' resolution) to activate this feature. -- section bathymetry polygons can now be exported to graphics object files. -- quality flags for derived quantities more accurate and consistent. -- iso-surface variables can now be defined or modified in all ODV modes. To calculate and display iso-surface variables you switch to SURFACE mode, e.g., by clicking on the "SURFACE F12" tab or pressing F12. -- in SURFACE mode, gridded field plots are now clipped to the station selection polygon/rectangle (if defined). station selection polygons or rectangles are specified using option "Selection Criteria>Domain>Polygon" (or "Selection Criteria>Domain>Zoom") from the map popup menu. -- support for indexed coastline/bathymetry files added. -- coastline/bathymetry converter coa2cdt.exe now included in ODV distribution package for Windows. Bug fixes since ODV(mp) 1.4: -- section bands in polar projections may now cross the "cyclic boundary". section segments may now be strictly vertical. -- clipboard copy now works under Linux and UNIX. -- many small bug fixes and changes ODV(mp) Release 1.4 Feb/10/2003: -- new option "Extras>Custom Estimation" for data plots with VG Gridding allows estimation of Z-values at arbitrary, user-specified X-Y points (read from file). See help file chapter 16.5 for more details. -- import from WHP exchange files improved: (1) "Time" variable may now be absent (00:00 used as default); (2) IGOSS quality flags now supported (in addition to WHP flags; user defined quality flags still not supported, "unknown" used as default in such cases). -- import from Java Ocean Atlas jos files much improved. WHP and IGOSS quality flags now supported (user defined quality flags still not supported, "unknown" used as default in such cases). -- support for ARGO netCDF files added -- drag-and-drop support for Java Ocean Atlas jos files and WOCE WHP exchange files (.csv) added. -- batch capabilities extended. ODV can now open netCDF files in batch mode. can also add annotions. -- new derived variable "Quality Flag" now lets you work with quality flags of a given variable. -- new derived variable "in situ density" -- option "Graphics Layout" renamed to "Window Layout". Accelerator key changed from Alt-G to Alt-W. -- creation and handling of overlay plots is now much simpler. overlay windows now align accurately (use new option Create Overlay Window when in "Window Layout" mode). -- repainting of the screen after printing or Save As (.png, jpg or .eps) no longer necessary. -- new "Configuration>Use Template>default" configuration template opens all selection criteria (selects all stations), uses a global map, defines 6 data windows, and switches to STATION mode). All other configuration templates preserve current map domain and selection criteria. -- new options "Help>Visit ODV Webpage" and "Help>Send ODV Bug Report". -- antialiased font support under Linux added. on some systems you may need to install additional shared libraries and/or TrueType fonts (see Linux installation instructions). -- many small improvements Bug fixes since ODV(mp) 1.3a: ALL PLATFORMS -- under rare circumstances drawing of continents in the map produced erratic dashed lines. -- Save As in .png or .jpg files would clip respective window, if output dpi was smaller than screen dpi. -- correct redrawing of ODV screen after change of set of variables (add, delete, reorder). Mac OS X -- Greek symbols now supported under Mac OS X -- current Gazetteer feature now highlighted in red ODV(mp) Release 1.3a Nov/12/2002: Bug fixes since ODV(mp) 1.3: ALL PLATFORMS -- under rare circumstances ODV would have problems identifying the respective variable if the mouse is over lines 2 and 3 of the ODV text window. this made editing the data and changing the variables settings more complicated and prevented some popup windows from appearing. ODV(mp) Release 1.3 Nov/11/2002: -- Date/Time selection criteria changed: you can now specify an arbitrary mon/day/year period and you can use the hh:mm day-time for selection. There is a new "Invert" tab that lets you invert the station selection, e.g., all stations that do NOT satisfy the criteria can be selected. -- potential vorticity and apparent oxygen utilization AOU now available as built-in derived variables. -- the Extras>Statistics option of data plot windows now allows to add the least-squares fit to the plot. the fitting curve is implemented as an ODV graphics object, e.g., you can edit its properties and you can delete it at any time. -- new operator abs available in ODV macros. also, you can now store intermediate results in internal variables using operators =%0, =%1, ..., =%9. You can use the stored values later in the calculation by using %0, %1, etc. -- in netCDF files attributes "_FillValue" and "missing_value" now recognized even if given in scaled units. -- "," (comma) now recognized as column separation character in ODV spreadsheet files. -- "Save Single As" option moved to map or data plot popup menu (renamed to "Save Map As" and "Save Plot As"). -- size of the graphics canvas can now be adjusted manually (Configuration>General Settings>Canvas; see help document for more information). -- two new oxygen conversions available during import ("Oxygen [ml/l] -> Oxygen [umol/l]" and "Oxygen [umol/l] -> Oxygen [ml/l]") Bug fixes since ODV(mp) 1.2: ALL PLATFORMS -- inventory information in popup window "Collection variables" more accurate. -- statistics information now correct even if sample selection criteria in effect. ODV(mp) Release 1.2a Aug/02/2002: -- more accurate coastline data in GlobHR series. download and install optional package odvmpOP_coastGlobHR_w32.zip (Windows) or odvmpOP_coastGlobHR.tar.gz (all other platforms). Bug fixes since ODV(mp) 1.2: ALL PLATFORMS -- error calculating vertical integral derived variables corrected. -- when changing section coordinates from Longitude (or Latitude) to Distance (or vice versa) the respective axis ranges are now automatically re-scaled. ODV(mp) Release 1.2 Jul/16/2002: -- Proper scaling of map and data plots now supported on displays with non-standard X/Y aspect ratios. -- more accurate bounding boxes when saving graphics of individual data plots. -- order of graphics file types changed to .png, .jpg, .eps. -- New atmospheric cfc mixing ratios (until Jun/1999). reference: Walker, S. J., R. F. Weiss and P. K. Salameh, Reconstructed histories of the annual mean atmospheric mole fractions for the halocarbons CFC-11, CFC-12, CFC-113 and carbon tetrachloride J. Geophys. Res., 105, 14,285-14,296, 2000. Bug fixes since ODV(mp) 1.1: Mac OS X -- numerous bug-fixes related to handling of popup menus, dialogs and zoom-boxes. "extra" mouse clicks or mouse moves no longer needed. double-clicks supported in same way as for other platforms. odvmp now has the ODV icon. ALL PLATFORMS -- ODV crash when trying to use Export>Export Plot Values in STATION mode -- using a derived variable as "Validate Variable" for sample selection criteria yields empty plot windows. -- export to ODV spreadsheet files does not write derived variables that depend on other derived variables. -- .png and .jpg output occasionally clips color bar and text annotations. ODV(mp) Release 1.1 Jun/10/2002: -- New option "File>Execute Command File" allows production of ODV graphics output and data spreadsheet files in batch mode. See help document for more information. -- More powerful wildcard matching for cruise labels implemented as part of the station selection criteria. -- You can now explore and visualize zipped netCDF files (.gz or .zip). Choose file-type "zipped netCDF Files" when selecting a netCDF file or simply drop the zipped netCDF file on the ODV window or icon. -- New option "Zoom Out" for map and data plots automatically enlarges X and Y ranges. -- Windows platforms: Newer gzip executable allows long .gz file-names. -- Multi-station selection procedure simplified: If you want to select from multiple stations at the same position (repeat stations, mooring instruments, etc.), hold down the SHIFT key while clicking the left mouse button in the map. ODV then presents a list of matching stations and lets you select one entry from the list. Without the SHIFT key, the first matching station is selected by default. Bug fixes since ODV(mp) 1.0: -- Problem with empty graphics files using "File>Save As" option resolved. -- Derived quantity "Difference from Reference" will now use the new reference directory. -- Export to collection now properly handles missing variables. -- Many small fixes. ODV(mp) Release 1.0 May/06/2002: -- odv(mp) is a multi-platform version of Ocean Data View and is based on version 5.7 of the "classical" ODV. Bug fixes since ODV(mp) 1.0(b2): -- installation problems under Windows 9x and Windows XP resolved. -- .png and .jpg problems resolved. -- orientation of arrows in projected maps now corrected. -- many small fixes and changes Major Improvements: -- odv(mp) is available for more platforms (Windows, UNIX, Linux, Mac OSX) and provides platform-independence of collection and configuration files. Data collection and configurations can be moved between platforms, and there is no need for translation. odv(mp) is backward compatible to the "classical" ODV and supports your previous data collections and configuration files. -- GIF and EMF support has been replaced by PNG (portable network graphics) and JPG support on all platforms. Most web browsers as well as graphics/office software packages support the png and jpg formats. As an important new feature, the resolution of .png or .jpg graphics files can be defined by the user and is no longer fixed to the screen resolution. Thus, it is now possible to obtain high resolution pixel files easily. -- contour-lines are now properly clipped and no longer interfere with contour labels, thereby increasing contour-label visibility. -- new "Define netCDF Emulation" wizard facilitates access to netCDF files and helps to avoid bad settings. -- during ODV Spreadsheet imports dummy values can be used for selected collection variables for which no data are provided in the import file. this allows visualization of X/Y/Z data from ASCII files (see help topic "Tips and Tricks"). -- odv(mp) has a hyperlinked html help system and now contains screen shots of ODV example plots and dialog boxes. You invoke help by using the Help option on the main menu, the Help buttons on many dialogs (context sensitive help) or by using your favourite web browser directly. The help files are located in the "doc" subdirectory of the ODV(mp) installation. Minor Differences to ODV5.7: -- The popup windows for current values (single or all variables) now show the data values and quality flags even for those data points that are filtered out by current sample selection criteria. -- The palette editor is available only on Windows. Workaround for other platforms: Create palette files with a text editor using existing files as templates, or use the palette editor on Windows and copy the palette files to your target system.