}

TUI

The Preferences window allows you to specify various application preferences (surprise!). It is brought up by selecting Preferences from the TUI 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.

  • Get Every: controls which science camera images are automatically downloaded:
    • 0 = no download
    • 1 = download every image
    • N = download every Nth image
    • -1 = download current images; if TUI can't keep up (e.g. slow bandwidth) then some images are skipped.

    Details:

    • Images are saved in a subdirectory of the Save To directory 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 active downloads using the Downloads window under the TUI menu.
    • Every camera's exposure window also has camera-specific Every and View Image settings. If you change a global setting then all camera-specific versions are updated to match, but the reverse is not true.
  • 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
  • Keep Guide Images: keep all guide images that are downloaded?
    • If False: all guide images are deleted, either when they fall off the end of the guide image history, or when you quit TUI. This helps prevent your disk space from mysteriously vanishing and is strongly recommended unless you need the guide images for some reason. If you just want to keep a few guide images, consider downoading them from APO or finding them on disk and copying them before they are deleted.
    • If True: all downloaded guide images are left on disk. It is up to you to prune them as needed to keep adequate disk space. If you let your disk fill up, applications will crash and you may corrupt your operating system.

Sounds

Specify sound files for various sound cues. 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. See pygame documentation for other supported formats.

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 cues can only be played if your computer is capable of playing sounds and the pygame library is installed (including the pygame.mixer package). 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: this menu allows you to set the edit field for all preferences (in all categories) to the specified state. The states are as follows:
    • Current: set all edit fields to the current values that the program is using
    • Initial: set all edit fields to the values that were in use when you first opened the Preferences window
    • Default: set all edit fields to their default values
    Note that "Show" only changes the edit fields. It does affect on the preferences used by TUI until you push Apply or Save.
  • Apply: applies the current value of all preferences (in all categories). This means TUI starts using the new values and they become "current". However, your changes will be forgotten when you quit TUI 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 TUI.

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. TUI 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 TUI 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.