A. Listed below is a basic checklist of steps to follow if your McIDAS-V is not working properly. Once you successfully complete each step in the process, restart McIDAS-V and try again. If the problem still exists, proceed to the next step, and so on.

1. Make sure that your drivers are up to date. Please see the Graphics Cards and Drivers section of the System Requirements page for more information.
2. Try the j3dtest script to verify that you can view the spinning cube. Please see the Java Versions section of the System Requirements page for more information. If this example does not work, then your system does not support Java3D. Instructions for running this test differ between operating systems:
   
   • Linux and macOS - cd to the directory where McIDAS-V was installed (likely the McIDAS-V-System directory) and run: ./j3dtest
   • Windows - From the Start menu, navigate through Programs to find the directory containing the McIDAS-V scripts. This directory is defined during the installation of McIDAS-V. Select the Java3D Test script. Alternatively, through a Command Prompt window, cd to the directory where McIDAS-V was installed (likely the McIDAS-V-System directory) and run: j3dtest.bat.
   Note: If your system does not support Java3D version 1.3.1+ McIDAS-V will not work for you.
3. Set a small heap size by setting the Memory option to 512 megabytes in the User Preferences window's Advanced tab. If this resolves the issue, you can start increasing the memory until the problem appears again. Stay below the memory value that produces the problem.
4. Disable Java Access to Image Data by Reference by unchecking Enable access to image data by reference option in the User Preferences window's Advanced tab.
5. Rename your McIDAS-V document directory to start with a clean set of options. This will undo the changes made in steps 3-4 listed above, but it will eliminate any corrupt startup bundles or settings.
6. Repeat steps 3-4 with a clean slate.

A. McIDAS-V files are divided into two categories: "system files" (supplied files that should not be edited) in the McIDAS-V-System directory and "user files" (new user-created files and supplied ones that contain user settings and preferences) that are in the McIDAS-V directory. The files in McIDAS-V-System are specific to the version of McIDAS-V. The files in McIDAS-V are not dependent on McIDAS-V version (such as XML files containing color enhancements, formulas, projections, etc.), so these settings will be carried from version to version. The system file directory can be changed during installation and its location defaults to the OS application directory (e.g., C:\Program Files on Windows, /Applications on OS X/macOS). The user file directory is created in the user's document directory (e.g., C:\Documents and Settings\user\ or C:\Users\user\ on Windows, /Users/user/Documents on OS X/macOS, /home/user on Linux). Files in these directories should not be edited by the user, but rather contact the McIDAS Help Desk or post to the McIDAS-V Support Forums for assistance if it is necessary to edit them.

A. The lower right corner of the Main Display window shows a box with progress bars if McIDAS-V is busy making a display or doing anything. In the status bar at the bottom, messages will appear when McIDAS-V is reading data from a server or disk. Also, while the displays are being created, there is usually a "please wait" notice in the lower left corner of the main display. When McIDAS-V is in the middle of a process in the Data Explorer window, the cursor will change to a spinning, blue ring.

A. McIDAS-V supports JPEG, PNG, and GIF image formats. McIDAS-V can also write out an image and the corresponding Google Earth KML or KMZ files. Animations can be captured as QuickTime movies or animated GIFs. See Image Captures for more information. You can save a particular McIDAS-V state with all displays, data sources, maps, etc. by saving the data as a bundle. You can also save a bundle as a favorite.

A. You can customize many of the McIDAS-V properties through the User Preferences window, accessed through the Edit->Preferences menu item in the Main Display window. This allows you to configure the many features of McIDAS-V.

You can set a bundle to open by default when you start McIDAS-V. To do this, save a bundle as a favorite and set it as your default bundle in the Defaults panel of the Advanced tab of the User Preferences window.

You can also set the locations of the Main Display window and the Data Explorer window, as well as the number of tabs and panels. To do this, save a default layout via the File->Default Layout menu item in the Main Display window.

A. You can change the amount of memory used by McIDAS-V by editing the Memory in the Advanced tab of the User Preferences window by selecting Edit->Preferences... from the Main Display window. See Running McIDAS-V for more information.

A. This can be controlled with the Projections->Auto-set Projection menu check-box. You can switch an existing display to its native data set projection using the display control's View->Use Data Projection menu.

A. The default projection is set with the Default Projection field in the Display Window tab of the User Preferences window. This window is accessed via the Edit->Preferences menu item in the Main Display. If you do not want to use any of the native projections of McIDAS-V, you can create your own projections with the Projection Manager which is accessed from the Projections->New/Edit menu item in the Main Display window. The default projection is overridden by the projection saved in the default bundle, or by displaying new data, if the Projections->Auto-Set Projection menu checkbox is checked on. As a result, you may never see the default map projection unless your default bundle has the default projection, and you have the checkbox checked off. Choosing a default map projection is not necessary to use of McIDAS-V, it is just a feature to allow for further user-customization of their sessions.

A. You can change the range for a display parameter in the Color Table Editor. This can be accessed in the Layer Controls tab of the Data Explorer by clicking the button next to Color Table, or by right-clicking on the color bar in the Legend of the Main Display window and selecting Edit Color Table. The range of the color table can be changed next to the Range button in the Color Table Editor. Alternatively, you can change the range outside of the Color Table Editor by right clicking on the color bar in the Legend of the Main Display window and selecting Change Range..., which opens a Change Range window where you can enter new values. If you always want to use a specific data range for a parameter, you can create a user parameter default so the range you desire will always be used when displaying the parameter. This can be done through the Tools->Parameters->Defaults menu item in the Main Display window to get to the Parameter Defaults Editor.

A. Using transparency in a color display may give unexpected results. In general, only the last thing added can be fully transparent. If you have a display that is transparent, then add in a new display, you may not see it. You can use the display control's View->Bring to Front menu to remove and re-add the display that you want to be transparent so it is last.

A. First, check that your display configuration is set to the maximum number of colors (e.g., 32 bit) so that McIDAS-V is able to display imagery and color tables using a full range of colors. If that is set correctly, it's possible that the range of values defined for the color table is less than the range of values in the displayed image. You can view or modify the range of values defined for the color table by right-clicking on the color bar in the Legend of the Main Display window and selecting either Change Range... or Edit Color Table. Right-clicking also displays other options that let you apply a different color table or edit the current one. If you created a contour display, you may also need to lower the Contour Interval in the Contour Properties Editor.

A. A displayed image can appear pixelated (blocky) due to one or more factors, including the resolution of the displayed image, the magnification and pixel sampling factors at which it was displayed, and the zoom factor.

For example, if you display an 8 km resolution image while zoomed in to a small geographic region such that each display pixel represents a higher resolution value (e.g., 1 km² of the earth surface) the image pixels need to be duplicated to fill the display and thus the image will appear pixelated. The same effect will occur with any image if you zoom in (using the Zoom/Pan Toolbar buttons or other zooming actions) to where the display resolution is higher than the image resolution.

If you believe that the displayed image is more pixelated than it should be for its given resolution, check the settings of the Magnification sliders in the Field Selector's Advanced tab and the Pixel Sampling slider in the Layer Controls tab. In order to display the image at the highest possible resolution (its native resolution), the line and element magnifications must be set to 1 (sliders all the way to the right) and the pixel sampling set to 0 (slider all the way to the left).

A. By default, there are three maps that are displayed: 'North & Central America', 'World Political Boundaries', and 'World Coastlines'. Other system maps are included with the Map Controls, and their visibilities can be toggled on and off. Additional maps are contained in plugins that can be found under the Maps category in the Plugin Manager. Users can add their own shapefile maps through the Edit -> Add Your Own Map menu item in the Layer Controls of the Default Background Maps. To set a new group of maps as the default, use the File -> Default Maps -> Save as the Default Map Set menu item. This creates a maps.xml file in the McIDAS-V directory that includes which map layers are displayed, as well as different display settings including the line thickness, style, and color. Once the default map is saved, this will be used any time a new tab or window is created, and it will be persisted between sessions. To remove a default map setting that has been saved, use the File -> Default Maps -> Remove Local Map Defaults menu item. Removing the default map set requires a restart of McIDAS-V to take effect.

A. The likely cause of this problem is that /bin/sh has been disallowed to control Terminal.app. This is an issue because the McIDAS-V launcher relies on using the Terminal to launch runMcV. Here are steps that can be followed to resolve this issue:

1. Open the macOS System Preferences.
2. Click on Privacy & Security.
3. In the Privacy section, select the Automation entry.
4. Enable the Terminal sub-entry. There may be a prompt for an administrator password.
5. Try the icon again to run McIDAS-V.