OPL MRR Release Notes


Title: OPL MRR
Author: Daniel P. Horn
Company: North Carolina State University
Description: OPL MRR

Change Log:

  1. Version 0.9.0.65 (Prerelease)
    04-10-2009
    1. Added support for compressed (.gz) NetCDF files to server app.
  2. Version 0.9.0.64 (Prerelease)
    04-01-2009
    1. Fixed time label problem in NOAA NetCDF files; times displayed should match filename timestamps; all should be GMT.
    2. Fixed problem with NOAA files not displaying Doppler Velocity values.
    3. Discovered problem with displaying NOAA files not displaying data when seconds per profiles is too low (eg may work with value of 30 but not with 1).
  3. Version 0.9.0.62 (Prerelease)
    03-18-2009
    1. Added new command line switch to server application for processing Miami and NOAA NetCDF files.
    2. Added new command line switch to server application for indicating the number of seconds per profile (previously, the default of 60 was always used); values between 1 and 3600 inclusive are now accepted.
    3. Removed NetcdfFile warning about logging.
    4. Cached files created for NetCDF files have source file name as prefix and timestamp part of name now includes hours, minutes, seconds of first profile.
  4. Version 0.9.0.61 (Prerelease)
    11-24-2008
    1. All filename matching tests for .MRR files should not be case insensitive.
  5. Version 0.9.0.60 (Prerelease)
    11-24-2008
    1. Change to OPL_MRR and server application to accept files with ".mrr" (lower case) extension. Note that in the case of the server application, this applies only to plain old ".MRR" extensions and not to ".ave.MRR", ".ins.MRR", etc. extensions.
  6. Version 0.9.0.59 (Prerelease)
    10-21-2008
    1. Improved support for Miami NetCDF files; fixed bug in which chart is not drawn correctly when chart height is too low
  7. Version 0.9.0.58 (Prerelease)
    10-6-2008
    1. Initial support for Miami NetCDF files (via File | Open dialog)
    2. Fixed migration bug in which filters were not correctly moved to new directory.
  8. Version 0.9.0.57 (Prerelease)
    6-23-2008
    1. Application now compiled against JDK 1.6
    2. Installer now installs JRE 1.6
    3. Location of application settings, reports, and data directories changed.
    4. If older locations detected for settings, reports, and/or data directories, application will move them to new locations for user.
    5. Color sets may now be set independently for each chart panel.
  9. Version 0.9.0.56 (Prerelease)
    3-6-2008
    1. Green icon added to "Live Data" button and menu item.
    2. Live Data functionality when site setting does not retrieve data from ftp or local server.
    3. Server application updated to accept ".MRR.gz" files: It is assumed that the decompressed file would have the same name as the compressed file without the ".gz" extension (that is, the type of data and its corresponding date are determined from the filename in the same way). The criteria for processing a ".MRR.gz" file is the same as for the corresponding ".MRR" file except that nothing is done with the file if a file in the same directory has the same name (minus the ".gz" extension).
  10. Version 0.9.0.55 (Prerelease)
    2-18-2008
    1. Initial support for "Live Data".
    2. Added new "View" menu for accessing commands previously only on buttons on toolbars.
  11. Version 0.9.0.54 (Prerelease)
    2-7-2008
    1. New feature: support for restricting chart height range.
  12. Version 0.9.0.53 (Prerelease)
    11-20-2007
    1. Revised logic for FTP downloads: a data file is now assumed to be under the subdirectory of the FTP path that is a) the year subdirectory of the subdirectory that is the year plus month (eg, "200711/2007") or b) the year plus month (eg, "200711") or c) the year ("2007") of the data's date. The b) subdirectory is searched only if the a) subdirectory is not found; and the c) subdirectory is searched only if the b) subdirectory is not found.
    2. CP3 logo image updated.
  13. Version 0.9.0.52 (Prerelease)
    11-13-2007
    1. Logic for FTP downloads modified slightly: a data file is now assumed to be under the subdirectory of the FTP path that is a) the year plus month (eg, "200711") or b) the year ("2007") of the data's date. The b) subdirectory is searched only if the a) subdirectory is not found. This change was made to reflect default output paths of Metek MRR devices, and to still allow earlier output assumptions to work where they are used instead.
    2. New button added to Date Range Options panel for setting date to today.
    3. Change to logic parsing .simp.asc files: Previously if a malformed line was found, it was assumed that the file was bad and not used. Now all data before malformed line is accepted. (File download may have occurred while file update was in process).
    4. Fixed bug in which cancelling changes on Date Range Options panel does not restore previous settings.
    5. Depressed toggle buttons now always reflect which charts are visible.
    6. CP3 logo image updated.
  14. Version 0.9.0.51 (Prerelease)
    09-11-2007
    1. Fixed problem in server application with checking for write permission in source directories
  15. Version 0.9.0.50 (Prerelease)
    07-02-2007
    1. Fixed paint problem with branding logo covering horizontal chart label when chart is narrow.
    2. Fixed main window resizing problem (color scale or Gates button might disappear).
  16. Version 0.9.0.49 (Prerelease)
    03-30-2007
    1. Added new option to allow reversing the time axis in charts.
    2. Fixed rounding bug in labels and tooltips for color scale bar.
  17. Version 0.9.0.48 (Prerelease)
    03-23-2007
    1. New command line option added to OPL_MRRServerApplication: second directory to search for MRR data files.
  18. Version 0.9.0.47 (Prerelease)
    03-22-2007
    1. Changes to parsing of derived velocity data to be smarter about handling problems with incomplete or incorrect data lines.
    2. Faster parsing of .gz files.
    3. Changes to make source code compatible with JRE 1.6
    4. Fix to OPL_MRRServerApplication problem with creating target subdirectories when source and target directories overlap.
  19. Version 0.9.0.46 (Prerelease)
    03-12-2007
    1. Search algorithm for .MRR data files modified again. Search for all different types takes place within a directory of the search path. If file is not found, only then is search repeated with the next directory in the search path. (Previously, search was for a single type across all directories in the search path before searching for next type).
    2. Filters now saved in .xml file to simplify sharing filter settings.
    3. "Import Settings" now includes importing the Filters.xml file.
    4. Tables in filter, gates, and time zone dialogs now reflect font change selections.
    5. Bug fix: when an incomplete or incorrect line is parsed in a .derived.asc file, the line of data is now skipped rather than causing the whole dataset to marked as invalid.
    6. Update to OPL_MRRServerApplication: in previous version, cacheing would only be performed on .ave.MRR and .raw.MRR files. Now, if a file ends in .MRR, it will assumed to be averaged data and cached if: it is not a .ave.MRR, .ins.MRR, or .raw.MRR file and the best guess for its date (based on a filename containing 8, 6, or 4 digits) has no other matches in its directory.
  20. Version 0.9.0.45 (Prerelease)
    03-09-2007
    1. Update to OPL_MRRServerApplication to support recent changes to OPL_MRR (ie, creation of .VR.derived.asc files).
    2. Cacheing is now only performed on .ave.MRR files (to create .simp.asc files) and .raw.MRR files (to create .VR.derived.asc files).
    3. Server application should now be more responsive when a request to close the application is made (application should now close within 15 seconds if it is not in the middle of processing a file).
  21. Version 0.9.0.44 (Prerelease)
    03-08-2007
    1. Filters may now be enabled/disabled directly using the filter settings dialog.
    2. Since it is possible that the user does not have write access to the directory in which a .gz file is found, the temporary file which is the decompressed version of the file is now created in the current site's cache directory.
    3. Refresh functionality, for now, only applies to server data, not local data.
  22. Version 0.9.0.43 (Prerelease)
    03-06-2007
    1. Filters replaced by extensible, user-defined filters; old toggle buttons for filters removed.
    2. Algorithm for .MRR data files (when corresponding .simp.asc file not found) modified:
      1. first see if a .ave.MRR file for the date exists in the search path; if found in a directory, it should be the only match;
      2. if not found, see if a matching .ave.MRR.gz file exists;
      3. if not, find a matching .MRR file that is not a .raw.MRR or .ins.MRR file;
      4. if not, find a matching .MRR.gz file that is not a .raw.MRR.gz or .ins.MRR.gz file.
  23. Version 0.9.0.42 (Prerelease)
    03-02-2007
    1. Support for loading and displaying data from .MRR.VR.derived.asc files.
    2. Modified Support for downloading (via ftp or net copy) to include derived velocity cache files.
    3. Added new panel to show source of data on screen (File | View Open Files...).
    4. When deleting cache files, derived velocity data files (.VR.derived.asc) files are now also deleted.
    5. Melting layer height is now only shown in the tool tip when its value is greater than 0.0.
    6. Undocumented functionality: File Open dialog not only opens .ave.MRR, .simp.asc, .VR.derived.asc files but also .raw.MRR and .raw.MRR.gz files. With these latter files, no data is displayed, but the associated .VR.derived.asc file is created which then can be opened and displayed as expected.
    7. Bug fixes related to recent changes for support of derived velocity data.
  24. Version 0.9.0.41 (Prerelease)
    02-26-2007
    1. Initial support for loading .MRR.VR.derived.asc files.
    2. Now distinguish between .raw.MRR, .ave.MRR and .ins.MRR files.
    3. Added file filters to File Open dialog.
    4. Added button to Date Range Options dialog for quickly setting end date same as start date.
  25. Version 0.9.0.40 (Prerelease)
    02-09-2007
    1. Experimental build for testing processing and display of raw MRR data files.
  26. Version 0.9.0.39 (Prerelease)
    02-01-2007
    1. Initial support for network share as source of refreshable data.
    2. Import Settings dialog simplified and no longer appears on first run of application.
    3. Fix for bug that cache files are stored in incorrect directory when new site is added.
  27. Version 0.9.0.38 (Prerelease)
    01-22-2007
    1. Initial support for MRR Velocity.
  28. Version 0.9.0.37 (Prerelease)
    01-08-2007
    1. The color scale is now saved with high resolution images.
    2. When run on Windows and a "My Documents" directory is found, the OPL_MRR_ directories are located under "My Documents".
  29. Version 0.9.0.36 (Prerelease)
    12-20-2006
    1. Site name added to filename of reports saved.
    2. Bug fixes.
  30. Version 0.9.0.35 (Prerelease)
    12-15-2006
    1. Bug fixes for recent changes.
  31. Version 0.9.0.34 (Prerelease)
    12-14-2006
    1. OPL_MRR_Settings directory split into OPL_MRR_Settings, OPL_MRR_Data, OPL_MRR_Reports directories.
    2. Cached directory setting for Site is no longer user setting; now automatically created under OPL_MRR_Data/CachedData directory.
  32. Version 0.9.0.33 (Prerelease)
    12-11-2006
    1. Ability to use centralized settings added.
  33. Version 0.9.0.32 (Prerelease)
    11-15-2006
    1. In the server application, when the source directory contains a data file with a name like "1122.MRR", then the application guesses that the year is the current year. It is important to note that when this is an incorrect assumption, the file will be re-cached every time the application performs the operation of checking for new raw data files. Therefore, it is important to recommend that users always have a year in the source file names (either "061122.MRR" or "20061122.MRR").
    2. New command line options and new meaning to -d option in server application. User must now specify both source (-s) and destination (-d) directory options.
    3. Branding image added to OPL_MRR charts and about box.
  34. Version 0.9.0.31 (Prerelease)
    11-09-2006
    1. The thread for checking for a date's FTP downloads will start making actual FTP connections 15 minutes before midnight at the start of the date (local to the server).
    2. The thread for checking for a date's FTP downloads will stop making actual FTP connections either 15 minutes after midnight at the end of the date (local to the server) or after 5 consecutive retry failures, whichever is later.
      More precisely:
      The thread for checking for a date's FTP downloads will continue making actual FTP connections for at least 15 minutes after midnight at the end of the date (local to the server). After that, the thread will then stop making FTP download attempts according to the following criteria:
      if the last FTP connection reported either that the file download successfully or that the file was already up to date, the thread finishes;
      otherwise, if the number of consecutive download attempts exceeds the allowable limit (5) -- for example, this might occur if the connection string is incorrect or if the server is down --, the thread ends.
      If none of these conditions occur, the thread goes to sleep for the refresh interval and tries a new FTP connection upon awakening.
    3. More logging messages added; if a site's setting for number of seconds per profile is too large, the condition will usually be detected and a message is logged.
    4. Bug fixes.
  35. Version 0.9.0.30 (Prerelease)
    11-07-2006
    1. Smarter management of threads for FTP downloads.
    2. Maximum number of threads for FTP downloads restricted to maximum number of days allowable in current date range selection.
    3. When using server data, "Refresh" button cancels sleeping threads for FTP downloads associated with current date range selection; new threads for those dates canceled are created and run.
    4. Bug fixes.
  36. Version 0.9.0.29 (Prerelease)
    11-06-2006
    1. New build of server application.
    2. Server application now requires -d setting to be made so that first time application is run (or is accidentally run), user will see help message without actually starting the program.
  37. Version 0.9.0.28 (Prerelease)
    11-03-2006
    1. Time zone browser added.
  38. Version 0.9.0.27 (Prerelease)
    10-25-2006
    1. Site settings dialog changed to tabbed dialog.
    2. Global "Use server data" option removed; replaced by site setting "Check for cached files on server".
    3. Time zone and observe DST options added to site FTP settings panel. Default values for these settings are based on the user's local time; in other words, in the absence of any other information about the server, it is assumed that the server is likely to be in the same time zone as the user.
    4. Better messages to user when invalid date/time range selected.
    5. Log viewer now loads only last 64 Kb of log file when application starts.
  39. Version 0.9.0.26 (Prerelease)
    10-24-2006
    1. Initial support for server vs. local data.
    2. Initial support for auto-refresh.
    3. Replaced FTPUrlConnection code with FtpBean (code from: http://www.geocities.com/SiliconValley/Code/9129/javabean/ftpbean/ :

      FtpBean
      Copyright 1999 Calvin Tai
      E-mail: calvin_tai2000@yahoo.com.hk
      URL: http://www.geocities.com/SiliconValley/Code/9129/javabean/ftpbean

      COPYRIGHT NOTICE
      Copyright 1999 Calvin Tai All Rights Reserved.

      )
    4. Added log file and viewer window of log.
    5. Fixed bug in tool tip when displaying height in feet.
  40. Version 0.9.0.25 (Prerelease)
    09-12-2006
    1. First version of OPL_MRRServerApplication.
    2. If a cache file for a data file exists, the application compares its last modified time with that of the data file to see if a new cache file should be regenerated.

      To do this, the application needs to know the name of the cache file it will generate. If the original data filename contains a string of exactly 8 digits, then it is assumed to follow the "yyyymmdd" pattern. If it contains exactly 6 digits, then it is assumed to follow the "yymmdd" pattern and a "20" is simply pre-pended to this date string to determine the cache file name. If it contains exactly 4 digits, then it is assumed to follow the "yymm" pattern and the year is determined from the last modified time of the original data file.

      If the filename fails to follow any of the above patterns, the data file is not cached.

      If the cache file with the name generated by the above rules does not exist, then the cache file will be regenerated. Note that this also means that if any of the assumptions made by the above rules (in particular, how the year is determined in the filename) is incorrect, then the cache file will always be regenerated.

      Even in the case where an assumption about the cache file name is incorrect, the actual cache file generated will always have the correct filename as it is based on information pulled out of the file and not on the filename
  41. Version 0.9.0.24 (Prerelease)
    08-21-2006
    1. Bug fix for displaying K ft.
    2. When saving melting layer heights to a text file, a missing height is now indicated by -99999 instead of 0.
  42. Version 0.9.0.23 (Prerelease)
    08-15-2006
    1. Added options for displaying melting layer height.
    2. Added new save as menu item for saving melting layer heigths to text file.
    3. Began initial changes to source code so that it is also usable in forecoming server application that "pre-caches" data files.
  43. Version 0.9.0.22 (Prerelease)
    08-14-2006
    1. Switched to builds with JDK 1.5.
    2. Minor changes to code to remove some deprecations, warnings, and code audits.
    3. Changes to installer to use newer JDK and to update changes to copyright, etc.; also removed Solaris from list of VMs installed with application.
  44. Version 0.9.0.21 (Prerelease)
    08-04-2006
    1. Initial support for showing freezing level height.
    2. Fixed bug that occurs when auto-scale colors are enabled.
  45. Version 0.9.0.20 (Prerelease)
    07-31-2006
    1. Interim release changing data interval assumption: in earlier versions, it was assumed that the data profiles occurred at most once per minute; it is now a user per-site setting that determines the number of seconds per profile. The default setting is 60 seconds per profile; the allowable range of values is 1 to 3600.
  46. Version 0.9.0.19 (Prerelease)
    07-24-2006
    1. Added new filters: dBZ on dBZ, and Doppler on Doppler.
    2. Added new toggle buttons to toolbar for enabling/disabling filters.
  47. Version 0.9.0.18 (Prerelease)
    07-10-2006
    1. Fix to layout of data options toolbar panel problem in which "Gates" button disappears.
  48. Version 0.9.0.17 (Prerelease)
    07-06-2006
    1. Layout of data options toolbar panel changed.
  49. Version 0.9.0.16 (Prerelease)
    06-29-2006
    1. Support for filters added.
    2. Bug fix for saving dBZ or Doppler image which is not visible on screen.
    3. Bug fix for gate height information dialog not taking ASL into account.
    4. Added "undocumented" /laf: command line switch to application for testing/debugging with different look and feel settings.
  50. Version 0.9.0.15 (Prerelease)
    06-16-2006
    1. Added toolbar button for viewing/changing the gate height selection.
    2. Support for refresh with .gz data files added.
    3. Bug fixes and minor cosmetic changes related to the gate height selection dialog.
  51. Version 0.9.0.14 (Prerelease)
    06-07-2006
    1. Support for multiple gate height info sets.
      Bug fixes to problems with previous build with data set consisting of more than one day's worth of data.
      Dialog now pops up when switching to data that has more than one gate height info set. The user now has the option of picking a set from a table that appears in the dialog.
  52. Version 0.9.0.13 (Prerelease)
    06-05-2006
    1. Initial support for multiple gate height info sets.
      Two lines in a data set belong to the same gate height info set if they have the same number of gates, the same first gate height, and the same gate height step interval.
      There is currently no UI for allowing the user to select a gate height set (if more than one such set is available), so the program currently assumes that the last gate height info set in a day's data file determines the gate height info to use for that day.
  53. Version 0.9.0.12 (Prerelease)
    05-26-2006
    1. Support for ASL added. Within a day's set of data, the ASL value used is always the last one found in the data file. Within a dataset's range of dates, the ASL value used is that of the last date in the date range.
    2. Directory "OPL_MRR_Settings" now used (instead of "OPL_MRR") to store configuration files, reports, and cache files. This change was made to avoid a name conflict that exists on certain platforms (eg, on Linux, in the earlier versions, the name "OPL_MRR" could not be used as a directory name in the user's home directory because the installation program defaulted to creating a link with that name).
    3. Cache file format change ("Version 1.0"):
      Version comment added to top of file and ASL value added to each data line. Each line of data no longer lists all height values. In new format, each line lists ASL value, the number of gates, the initial gate height value, the gate step value, and then the remainder of the values. Old format cache files ("Version 0", actually no version label included in file) are still read in correctly, but a new format cache file is created and the name of the old file is changed by adding a ".V0" suffix.
    4. Scales for dBZ and Doppler no longer default to "auto-scale". The default/starting scale range for dBZ is now 0 to 45 and for Doppler is not 0 to 8.5.
    5. Default color set changed; now equivalent to "hotcold16" set.
    6. Cosmetic changes to UI to improve appearance on non-Windows look and feels (eg, Linux).
    7. Bug fixes include: the program now avoids loading data files multiple times on application start up.
  54. Version 0.9.0.11 (Prerelease)
    05-11-2006
    1. No data is displayed (nor data file processed) if current radar site does not have a valid cache directory.
    2. When adding or modifying radar site settings, the user will be prompted to create the cache directory if it does not already exist.
    3. More helpful information is provided in message box which indicates that radar site settings may be incorrect (eg, a directory is not valid).
    4. Radar site list dialog has button for validating settings of selected site.
    5. Confirmation message boxes when the user chooses to delete cache files.
    6. If raw file opened is a compressed (".MRR.gz") file, then the decompressed (".MRR") file that is created is now deleted after processing the data.
    7. Cosmetic changes include: narrower vertical margins around the graphs; some truncation problems involving graph labels have been fixed.
  55. Version 0.9.0.10 (Prerelease)
    05-06-2006
    1. Fix for install/initialization problem that occurs when selecting initial radar site on newly installed version of application.
  56. Version 0.9.0.9 (Prerelease)
    05-02-2006
    1. Initial support for multiple radar sites added. Notes: When switching to a site, the application performs some checking that the site settings are valid (eg, that the search directories and the cache directory exist). If there is something wrong here, the application will pop up a warning but will otherwise continue operating as if no problem occurred. This should be okay in most cases since these settings may only be added or modified using the application (and they are validated at that time). However, it is always possible that the user deleted a directory after creating the radar site settings; this is a potential problem that the program is lax in addressing.
    2. Sample data is added to application and installation so that the initial radar site selection has data. The current data supplied is for the date 2004/11/30. This file was chosen from the initial sample data set that I had based on it having relatively few gaps.
    3. Differences from earlier versions of this application include:

      The data search algorithm is slightly different.
      The application first searchs for data by looking in the cache directory for a cached version of the file;
      if not found, then a raw data file is sought in the directories in the search path list
      (ie, The cache directory is no longer added to the search path list).

      *** If the user does not name a different cache directory for each radar site, then it is possible that an incorrect cache file will be used.
      Also, the "Clear All Cache Files" command performs a delete of all cached files from the current site's cache dir, so having a common cache dir would result in more being deleted in this case.
  57. Version 0.9.0.8 (Prerelease)
    03-23-2006
    1. Fixed problem with colors in chart not matching those in color bar.
  58. Version 0.9.0.7 (Prerelease)
    02-08-2006
    1. Added support for .gz files:
      When loading a file for a specified date, if no cache file or .MRR file exists for that date, but a ".MRR.gz" file for that date is found (using the same search path as for .MRR files), then it is used.
      The <Filename>.MRR.gz file is first decompressed to a file named <Filename>.MRR (in the same directory as the .gz file) and then the .MRR is opened as usual.
      Note that this decompressed .MRR file (not the .MRR.gz file) will be used in the future if the associated cache file is deleted.
    2. In current version, if original source file is a ".gz", then application will always report "no new data" when attempting a refresh.
    3. New support for searching for data files based on date string
      (eg, yyyyMMdd (filename contains 4 digit year followed by 2 digit month and 2 digit day of month)).
      Filename must end with either ".MRR" or ".MRR.gz" extension.
      Choose the "Data Search Path Settings..." menu item to set the date pattern string. Note that this has no affect on the naming convention used for simplified/cached files.
    4. Refresh bug fixes.
    5. Support for saving full chart JPEG images (ie, for each of dBZ and Doppler Velocity, an image of the chart panel that contains one horizontal pixel for each minute in the time range; the height of these images is the same as their height in the window). The width of these charts in the window image is determined by the window width; as it is a "bltted" image, some columns may be missing.
  59. Version 0.9.0.6 (Prerelease)
    01-06-2006
    1. Added support for .gz files:
      When loading a file for a specified date, if no cache file or .MRR file exists for that date, but a ".MRR.gz" file for that date is found (using the same search path as for .MRR files), then it is used.
      The <Filename>.MRR.gz file is first decompressed to a file named <Filename>.MRR (in the same directory as the .gz file) and then the .MRR is opened as usual.
      Note that this decompressed .MRR file (not the .MRR.gz file) will be used in the future if the associated cache file is deleted.
    2. In current version, if original source file is a ".gz", then application will always report "no new data" when attempting a refresh.
    3. New support for searching for data files based on date string
      (eg, yyyyMMdd (filename contains 4 digit year followed by 2 digit month and 2 digit day of month)).
      Filename must end with either ".MRR" or ".MRR.gz" extension.
      Choose the "Data Search Path Settings..." menu item to set the date pattern string. Note that this has no affect on the naming convention used for simplified/cached files.
    4. Refresh bug fixes.
    5. Support for saving full chart JPEG images (ie, for each of dBZ and Doppler Velocity, an image of the chart panel that contains one horizontal pixel for each minute in the time range; the height of these images is the same as their height in the window). The width of these charts in the window image is determined by the window width; as it is a "bltted" image, some columns may be missing.