STUI

The Preferences window allows you to specify various application preferences (surprise!). It is brought up by selecting Preferences from the STUI Menu.

Preferences

The list at the left selects the category; preferences in the selected category are shown in the area to the right. Each preference may be edited by clicking on it. If the value is changed to anything other than the current value then an exclamation mark is shown between the name and the value.

Connection

• User Name: default value for the "User Name" field of the Connect window. You are free to choose your own name, but spaces and special characters are not allowed.
• Host: the IP address of the hub, optionally followed by a space and a port number (which defaults to 9877). This field should be hub35m.apo.nmsu.edu unless you are told otherwise.

Exposures

• Seq By File: controls whether whether images are numbered in the order taken (unchecked) or are numbered separately for each image name (checked). For example, suppose you take two images named "bias", two named "flat" and one more named "bias". Numbering in order (unchecked) yields: bias.0001.fits, bias.0002.fits, flat.0003.fits, flat.0004.fits, bias.0005.fits. Numbering by file name (checked) yields: bias.0001.fits, bias.0002.fits, flat.0001.fits, flat.0002.fits, bias.0003.fits.

  Note: this setting only applies to images within a particular directory; numbering always starts over for images in a new directory.

• Auto Get: if checked, and if a valid Save To directory has been set, images are automatically downloaded to your computer.
  • Images are saved in a subdirectory that matches the structure at APO, including your program name and the current date.
  • If a matching file already exists in your destination directory, the automatic download fails, but the image is still saved at APO.
  • You may view the status of downloads and abort downloads using the Downloads window under the STUI menu.
• Get Collab: if checked, collaborators' images are retrieved, else only images you take are retrieved. Collaborators are people logged in using the same program name as yourself. (Ignored if Auto Get is disabled.)
• Save To: directory used to save science images and the most recent guide images. Science images are saved in a subdirectory hierarchy that includes your program number and the date of observation (the same hierarchy used at APO in /export/images). Thus you may use the same Save To directory for all of your work, without fear of overwriting images or losing track of which image was taken when or for which program.
• View Image: if checked, images are displayed in ds9 after they are downloaded. Auto Get must be checked and a valid Save To directory selected for View Image to have any effect.
• UMask: controls permissions for saved images and image directories, preferences files and the error log. Useful values include:
  • 077 for maximum privacy
  • 027 to allow read access to group members, but no access to others
  • 022 to allow read access to everyone (group and other); this is often the default
  • 002 to allow read/write access to group members and read access to others

Sounds

Specify sound files for various sound queues. The recommended format is .wav with a sampling rate of 22.05 or 44.1 KHz, as this seems to be compatible with most computers. Other formats that may work include mp3, au, snd, aiff, sd, smp, csl and raw binary.

If you uncheck "Play Sounds" then all sound cues are turned off except "Command Done" and "Command Failed" in response to your own commands. This allows users to run multiple TUIs in the same room with only one copy playing sound cues. It also allows users to quietly monitor what is going on.

Sound queues can only be played if your computer is capable of playing sounds and the "snack" sound library is installed. Otherwise a substitute beep pattern is played (a pattern you cannot change). Note that X terminals can only beep, and some may not even be able to do that.

Other Controls

The controls along the bottom are as follows:

• Show: allows you to set the edit field for all preferences (in all categories) to the specified state. The states are as follows:
  • Current: set edit field to the current value that the program is using
  • Initial: set edit field to the value that was in use when you first opened the Preferences window
  • Default: set edit field to the default value for this preference
  Note that "Show" only changes the edit fields. It does affect on the preferences used by STUI until you push Apply or Save.
• Apply: applies the current value of all preferences (in all categories). This means STUI starts using the new values and they become "current". However, your changes will be forgotten when you quit STUI unless you also Save.
• Save: applies the current value of all preferences and then writes the preferences out to your preferences file. They will then be remembered for next time you run STUI.

Each preference also has a contextual menu which supports at least the following for just that one preference:

• Current: set this one edit field to the current value that the program is using
• Initial: set this one edit field to the value that was in use when you first opened the Preferences window
• Default: set this one edit field to the default value for this preference
• Apply: apply this one preference. STUI starts using the value in the edit field and thus it becomes the current value. The value is used but not saved unless press the Save button (see above).

Warning: if you close the preferences window without applying changes, you are not warned. I hope to fix this eventually.

Preferences File and Window Geometry File

The paths to the preferences and window geometry files are shown in the About STUI window. Both files are plain text and are easily edited by hand. Errors in a file may give odd results but should not cause instability.