Release Notes
The items below list the changes in McIDAS-V for the most recent release
version. For the release notes of previous versions, see Previous Release Notes.
For a current list of known bugs and requested enhancements, please see the
Open
Inquiries Report from the McIDAS-V
Inquiry System. To view the items currently under development, see the
list of Critical
Bugs and Critical
Development Items.
McIDAS-V
Version 1.6
The items below reflect the changes since the 1.5 release.
McIDAS-V User's Guide
Updated the McIDAS-V User's Guide to contain new
features and more detailed content.
Flow Display Controls
Added new display types for Vector Colored by Speed, Vector Colored by Another Parameter, Wind Barb Colored by Speed, and Wind Barb Colored by Another Parameter. Additionally, if four or more timesteps are displayed, new features in the Layer Controls allow for changing the display to trajectories or curly vectors. If trajectories are chosen, then there are four options for how the trajectories are drawn. These options are Line, Cylinder, Ribbon, and Deform Ribbon. Curly vectors are the same as regular vectors, with the exception that they are multiple timesteps in length.
3D Flow Display Controls
Added new display types for 3D Volume Vector, 3D Volume Vector Colored by Speed, 3D Volume Vector Colored by Another Parameter, and 3D Volume Trajectory. For these display types, there is the option to switch between displaying vectors and trajectories. When trajectories is chosen, there are different options for setting how the trajectories are drawn in the display. These options are Line, Cylinder, Ribbon, and Deform Ribbon. By default, the trajectories will be drawn at every vertical level included with the data at the specified Z Skip which is defined in the Layer Controls. The Trajectory Start Level dropdown menu can be used to set trajectories to originate at a single vertical level instead of all levels at once. Four or more timesteps must be displayed in order to plot trajectories.
New Transect Tab and Window Types
Added new transect tab and window types that can be accessed in the Main Display window. The new types include:
- File>New Display Tab/Window>Transect Display>Three Panels
- File>New Display Tab/Window>Transect Display>Four Panels
- File>New Display Tab/Window>Misc>1 Map 2 Transects
- File>New Display Tab/Window>Misc>2 Maps 1 Transect
Automatic Depth Offsetting
Added a new setting that displays overlapping layers of differing resolutions in a way that there is no display interference when the display is rotated. This setting is enabled by default in the Display Window tab of the User Preferences. This setting can also be controlled on a display by display basis through the View>Properties menu in a panel.
Himawari Local Server
Added a new local server to work with Himawari HSD (Himawari Standard Data) formatted files (*.DAT). To create a local dataset using this server, from the ADDE Data Manager, click the Add New Dataset button and select the 'Himawari 8' Format. The file names must match the JMA HSD image file naming convention,
HS_aaa_yyyymmdd_hhnn_Bbb_cccc_Rjj_Skkll.DAT, described in the
Himawari Standard Data User's Guide. This server is currently supported on Linux and OS X.
INSAT-3D Local Servers
Added new local servers to work with INSAT-3D Imager and Sounder files (*.h5). To create a local dataset using this server, from the ADDE Data Manager, click the Add New Dataset button and select the 'INSAT-3D Imager' or 'INSAT-3D Sounder' Format. These servers are currently supported on Linux and OS X.
GOES-16 ABI Local Servers
Added new local servers to work with Level 1b GOES-R ABI files in the netCDF-4 format. The names of these files should look similar to this: OR_ABI-L1b-RadC-M4C16_G16_s20151702215532_e20151702220362_c20151702220394.nc. To create a local dataset using this server, from the ADDE Data Manager, click the Add New Dataset button and select the 'GOES-16 ABI' Format. These servers are currently supported on Linux and OS X.
Listing of Fields from a NetCDF Data Source
Added a new button to the top of the Fields panel of the Field Selector to toggle between the longname and shortname descriptions of each field in the data source. This is only an option if the fields populating the Fields panel are from a NetCDF-formatted data source.
Julian Date with Archive Servers
Added the ability to work with Julian dates with archive imagery servers. Once an Image Type is selected in a chooser, in the Set Archive Day window, Julian dates can be entered. For example:
- 001 - Day 1 of the current year
- 13255 - Day 255 of year 2013
- 2015150 - Day 150 of year 2015
In the past, users were limited to entering dates such as 'Jun 19, 2015'.
List All Images Button
Added a List All Images button to the Absolute times tab of the Satellite>Imagery chooser. By default, only up the 100 most recent images in the dataset will be listed to save time. Clicking this button requests the server to list all of the relevant times in the times panel. Dependent on the server and number of images in the dataset, this may take some time to complete.
Animated GIF Global Color Palette Option
Added a 'Use 'global' GIF color palette' option when saving a movie. This option is applicable for animated GIF movies, and it is enabled by default. Animated GIFs are limited to 256 colors, and this option uses the same 256 colors for every frame in the loop when the setting is enabled. Enabling this option allows for certain display settings such as a color scale to remain constant throughout the loop. If this option is disabled, then each frame uses it's own color palette, so one color may represent one value in one frame, and the same color may represent a different value in the next frame. One circumstance where disabling this option may be ideal is if the movie starts with a low-light scene (not many colors) and there is no color scale in the display.
Scripting
Added a variety of functionality related to scripting since the release of 1.5. Below is a list of significant changes:
- New functions:
- Added a new function called setMapVisibilityByDescription() that allows for showing or hiding individual maps from the display.
- Added a new function called findWindow() that returns a reference to the display window containing a buildWindow() panel. This allows for performing operations on a window such as adding new tabs or closing the window.
- Added new functions to modify displays of point data, which are outlined in the 'Modify the Layer Object - Point' page.
- Added a new function called getData() which returns a data object from a displayed layer. This data object can then be passed through formulas.
- Added new lister functions for Suomi NPP VIIRS data (described below in the Under Development section).
- Added a new function called describe() which returns a variety of statistical parameters about an imagery or gridded data object. These statistical parameters include a histogram, length, min, max, range, Q1, Q2, Q3, IQR, mean, mode, kurtosis, skewness, standard deviation, and variance.
- Added a new function called sparkline() which returns a histogram of data values from an imagery or gridded data object.
- Added a new function called importEnhancement() which allows for importing local enhancement files for use in scripts and the user interface.
- Added a new function called sandwich() which is defined in the Sandwich Product library in the Jython Libraries. This function creates a sandwich RGB display using infrared and visible data, as well as user-defined minimum and maximum infrared values, a color enhancement, and the ability to specify if missing values should be plotted in the display.
- New functionality with existing functions:
- Added new information to the metadata of the data object returned from loadGrid. This new metadata is in the form of three new keys: globalAttributes, metadataVariables, and variableAttributes. Information on accessing these keys and their values can be found on the 'Create an Object - Grids' page.
- Added a new keyword to the captureImage() and writeMovie() functions called createDirectories. This createDirectories key, if set to True, allows for the creation of the directory path specified in the command if it does not already exist.
- Added new fontSize and fontFace keywords to the Colorbar formatting option of captureImage.
- Added a new keyword to buildWindow called widgets. This keyword, if set to false, builds a display window without any toolbar buttons and only the display panel.
- Miscellaneous scripting-related changes:
- For remote datasets requiring accounting that are already defined in the ADDE Data Manager, there is no need to specify the accounting keyword in the imagery-related functions. This includes loadADDEImage, listADDEImages, and listADDEImageTimes. A benefit of this change is that users can share scripts without including any accounting information.
- Added syntax highlighting to the Jython libraries window. Also added keyboard shortcuts to assist with searching for text in the currently open library.
- Added syntax highlighting to the Jython Shell window when multi-line input is being used.
- Print statements are no longer required in the Jython Shell when a single line of code is being evaluated. Below are a couple of examples:
- Command: 2+6
- Output: 8
- Command: layer.getEnhancementTable()
- Output: Inverse Gray shade
Java Version
Updated Java version from 1.7.0_60 to 1.8.0_45.
Updates to Installation GUI
Updated the installation GUI. The first update is that the GUI now prompts the user if McIDAS-V should be installed into the same directory that McIDAS-V was last installed into (overwriting any previous version), or if it should be installed into a different directory. If the option of installing into the existing installation directory is selected, then the installation GUI will skip the step where the installation directory is selected. If the user selects to install into a different directory, there is a new feature that allows for the creation of a new directory within the installer. There were also updates to allow for installing into and running from directory paths that include spaces.
Support for AWIPS II cmap Colormaps
Added support for AWIPS II *.cmap colormaps (enhancements). These files can be imported through the Color Table Editor.
Suomi NPP Chooser
Added support for subsetting EDR and SDR granule aggregations containing missing scanlines. Added initial support for NASA VIIRS L1b formatted files. Also added a couple new functions to list information about VIIRS files:
- listVIIRSFieldsInFile(filename) - Returns a list of the fields included with the file passed through the function. These field names can then be passed through the loadVIIRSImage() function to create a data object that can then be displayed.
- listVIIRSTimesInField(filename, field) - Returns the beginning date and time of the file passed through the function.