Sets the appropriate guide star filter position for the specified obset_id
in the database based upon the FGS and Magnitude.
 
TITLE:      set_filter_pos.py
DEVELOPER:  Merle Reinhart, 14-Jun-2000
 
PURPOSE:    To set the guide star filter position in the database relation
            wguide_stars.
 
MOD HISTORY: 
- Rework to support clear filter guiding - mdr 1/20/14

Functions
		run(*args) Sets the guide star filter for the provided obset based upon the FGS and Magnitude.   Usage:     do set_filter_pos <obsets> [-setfilter|-resetfilter] [-fgs1=<mag1>]                           [-fgs2=<mag2>] [-fgs3=<mag3>]          where <obsets>     is either a comma separated list of obsets                              in ppppp:oo:vv format or a filename that                             contains a list of obsets in ppppp:oo:vv                              format with one obset per record.  To                              indicate a file input, this parameter must                              start with either a ~ (VMS) or a % (Unix).                  -setfilter   will set the appropriate filter if                             it is currently not set in the database.                             The default is -setfilter.                  -resetfilter will set the appropriate filter                             regardless of the current db setting.                             -setfilter and -resetfilter are mutially                              exclusive                  -fgs1=<mag1> Allows the default magnitude where FGS1                             will switch from PUPIL to CLEAR guiding.                             Default is env var FGS1_CLR_SWITCH_MAG                                             -fgs2=<mag2> Allows the default magnitude where FGS2                             will switch from PUPIL to CLEAR guiding.                             Default is env var FGS2_CLR_SWITCH_MAG                                             -fgs3=<mag3> Allows the default magnitude where FGS3                             will switch from PUPIL to CLEAR guiding.                             Default is env var FGS3_CLR_SWITCH_MAG

Data
		__version__ = '01/20/14'