Data model: plan-bossN

General description: Plan file for chunk N in the BOSS tiling. This specifies the various parameters for which target lists to use, as well as other parameters.

Naming convention: plan-bossN.par

Approximate size: 2 kbytes.

File type: Yanny

Read by products: bosstile

Written by products: hand-editted

Required header keywords:

• chunknumber (int32): chunk number N (should agree with file and directory names (e.g. "bossN")
• standards (string): file with list of standard stars from target selection
• tilerad (float32): tile radius to assume (deg)
• collisionangle (float32): angle of collisions to exclude (arcsec)
• nfibers (int32): number of primary fibers available per tile (that is 1000 minus standards minus skies minus repeats)
• nrepeat (int32): number of repeat fibers to guarantee
• maxrepeat (int32): maximum number of tiles a single target can be put on
• completeness (float32): fractional complete we are searching for; if not achieved, WARNING is spawned in the logs, but the process completes
• centerpost (float32): exclusion radius around center post (arcsec)

Optional header keywords:

• trim_geometry_file (string): mangle-style polygon file specifying any geometrical trimming to be done to the chunk area (if not set, then assume the full boundaries of the tile locations specified in the bosstiles.par file intersected with the survey geometry specified in the boss_survey geometry file.

There are two structures:

• BOSSINPUTS: contains list of files to pull targets from; each file specified needs to be in the targets-bossN.fits format.
  • filename (string): name of file (assumed to be in this directory
  • offsetpriority (int32): offset to add to priority value (so we can de-prioritize targets in some files
  • ancillary (int32): 0 if this file contains BOSS targets, 1 if this file contains ancillary targets
• REPEATCLASS:
  • repeat_priority (int32): in the repeat pass, assign extra fibers to classes in this priority order (lowest first)
  • boss_target1_repeat (int64): bitmask to search for for finding targets in this repeat class
  • boss_target2_repeat (int64): bitmask to search for for finding targets in this repeat class
  • ancillary_target1_repeat (int64): bitmask to search for for finding targets in this repeat class
  • ancillary_target2_repeat (int64): bitmask to search for for finding targets in this repeat class
  • comments (string): comments describing the repeat class

Example file: plan-boss1.par