McIDAS-X User's Guide
Version 2024.1
[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]
The McIDAS-X software container is installed in each user's account. Other users on the workstation must maintain their own containerized installation.
1. Log on to your user account. Update or create a $HOME/.bash_profile (for bash) or $HOME/.zprofile (for zsh) file to include the following line, so that .profile is sourced and the PATH and McIDAS environment variables that are defined in .profile and .mcenv are set each time you log on to the account.
# source the .profile . $HOME/.profile |
2. Modify the environment variable PATH in your $HOME/.profile file. Insert $HOME/mcidas/bin and /home/mcidas/bin, in that order, at the beginning of your PATH by adding the set of lines below.
# recommended PATH setting for McIDAS-X: export PATH=$HOME/mcidas/bin:/home/mcidas/bin:$PATH |
Note: The changes above will take effect the next time you open a shell logged into the user account.
3. Log off and log on again for the changes to take effect.The actions required to enable certain keyboard keys used by McIDAS-X (for example, Alt A, Ctrl F11) vary depending on your workstation and its configuration. This section describes these actions for workstations running SSEC-recommended configurations.
Complete the section appropriate for your configuration. The directions assume that you are in the account's $HOME directory and logged on to the workstation console.
Enabling McIDAS-X Keys for macOS and XQuartz
Complete the steps below if you use a macOS workstation console and Apple's XQuartz desktop environment.
1. Start XQuartz by double-clicking the XQuartz icon in the Applications>Utilities folder. If XQuartz is already running, click the XQuartz icon in the dock to make the application active.
2. Click the XQuartz menu at the top of the display, then click Preferences to bring up the X11 Preferences window.
3. Click the Input tab, then uncheck the checkbox labeled Enable key equivalents under X11.
Steps 1-3 allow the open-apple keys (on each side of the spacebar) to function as the Alt keys in McIDAS-X.
4. Start a Terminal by double-clicking the Terminal icon in the Applications>Utilities folder. If a Terminal is already running, click the Terminal icon in the dock to make the application active. Then use the xmodmap utility to configure a key to function as the Insert key during McIDAS-X command entry. Choose the appropriate command below, depending on whether you have a fullsize (desktop) keyboard or a laptop.
On a fullsize keyboard, run the command below to configure the help key to function as Insert. The spaces before and after the equal sign (=) are required.
Type: xmodmap -e 'keysym Help = Insert'
Type: xmodmap -e 'keysym Mode_switch = Insert'
This concludes the instructions for configuring user accounts on macOS. Contine to the next page for Obtaining and Installing McIDAS-X. See Starting McIDAS-X for information about the ways to start a McIDAS-X session, and see Configuring McIDAS-X Sessions with .mcidasrc for information about tailoring McIDAS-X sessions to your preferences.
[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]