!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!
! SDDL Name:	OFF_NOM_ROLL_TUNE_PARMS.SDDL
!
! Purpose:      This include file contains off nominal roll tuning parameters
!
! Modification History:
!
!   Date       OPR      Who                       Reason
! --------   -------    ---   -------------------------------------------------
! 07/12/89     16196  SPSS    Special Project 15.2,Off-Nominal Roll 
! 12/14/94    27329     MRB   Original SDDL implementation
!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!
!

LANGUAGE	FORTRAN


    DESCRIPTION     "off nominal roll tuning parameters. Loaded by name list
                     WRLTUN.NML"


!------------------------------------------------------------------------------
!
!   FIELD INFORMATION
!
!------------------------------------------------------------------------------

    INSTANCE  wrlsunpntres
        TYPE            R*4
        UNITS           "DEGREES/ITER"
        DESCRIPTION     "this parameter specifies the step or resolution
                        of the change in the sun point angle for an
                        iteration by worolstep.  this value should be set
                        to 1/2 the minimum distance between possible sun
                        angles.  in other words, the minimum of:
                        wrlsunpntsf/2  or the smallest delta in sun point
                        angles/2. Therefore a recommended value is
                        0.125 degrees, (wrlsunpntsf/2). "


        GLOBAL          off_nom_roll_tune_parms
    END_INSTANCE

    INSTANCE  wrlrollres
        TYPE            R*4
        UNITS           "DEGREES/ITER"
        DESCRIPTION     "this parameter specifies the step or resolution
                        of the change in the v3 position angle for an
                        iteration by worolstep.  a recommended value
                        is 1.0 degree per iteration. "
        GLOBAL          off_nom_roll_tune_parms
    END_INSTANCE

    INSTANCE  wrlminsteptime
        TYPE            I*4
        UNITS           "SECONDS"
        DESCRIPTION     "this parameter specifies the minimum step
                        time that can be returned for an iteration
                        by worolstep. A recommended value is 3600
                        seconds. "
        GLOBAL          off_nom_roll_tune_parms
    END_INSTANCE

    INSTANCE  wrlmaxsteptime
        TYPE            I*4
        UNITS           "SECONDS"
        DESCRIPTION     "this parameter specifies the maximum step
                        time that can be returned for an iteration
                        by worolstep. A recommended value is 86400
                        seconds. "
        GLOBAL          off_nom_roll_tune_parms
    END_INSTANCE

    INSTANCE  wrlslopetime
        TYPE            I*4
        UNITS           "SECONDS"
        DESCRIPTION     "this parameter specifies an arbitrary initial
                        time delta to determine the slope of the nominal v3
                        position angle and the sun point angle
                        by worolstep. A recommended value is 3600
                        seconds. This value should not be set smaller than
                        60 seconds or greater than 1 order of magnitude less
                        than wrlmaxsteptime. "
        GLOBAL          off_nom_roll_tune_parms
    END_INSTANCE

    INSTANCE  wrlscalefactor
        TYPE            R*4
        DESCRIPTION     "this parameter specifies the step or resolution
                        scale factor for an iteration by worolstep.
                        worolstep calculates a time when the roll and
                        sun point has not changed by wrlrollres and
                        wrlsunpntres. The scale factor is multiplied
                        by delta time to give a conservative time
                        estimate.  a recommended value is 0.95. "
        GLOBAL          off_nom_roll_tune_parms
    END_INSTANCE

    INSTANCE  wrltimetol
        TYPE            I*4
        DESCRIPTION     "this parameter specifies the time tolerance
                        used in woroltrans to stop the iteration
                        search for the transition time.  when the
                        bisection time span is less than the time
                        tolerance, the iteration is done. "
        GLOBAL          off_nom_roll_tune_parms
    END_INSTANCE

    INSTANCE  wrlsunpntsf
        TYPE            R*4
        UNITS           "DEGREES"
        DESCRIPTION     "this parameter specifies a sun point safety
                        factor to be applied to the pdb roll data
                        for the solar array shadow, the tcs,
                        and the solar array incidence data.
                        this safety factor is used to adjust the
                        sun point data values by plus or minus this
                        safety factor to obtain a conservative value.
                        a suggested value is 0.25 degrees. "
        GLOBAL          off_nom_roll_tune_parms
    END_INSTANCE

    INSTANCE  wrlrollsf
        TYPE            R*4
        UNITS           "DEGREES"
        DESCRIPTION     "this parameter specifies a roll safety
                        factor to be applied to the pdb roll data
                        for the solar array shadow, the tcs,
                        and the solar array incidence data.
                        this safety factor is used to adjust the
                        roll data values by plus this safety factor
                        to obtain a more conservative value.
                        a suggested value is 0.1 degrees. "
        GLOBAL          off_nom_roll_tune_parms
    END_INSTANCE

    INSTANCE  wrlincsf
        TYPE            R*4
        UNITS           "DEGREES"
        DESCRIPTION     "this parameter specifies a solar array
                        incidence safety factor to be applied
                        to the allowable solar array incidence
                        angle.  this safety factor is used to
                        adjust the solar array incidence angle
                        to obtain a more conservative value
                        because the x,y aperature offset is not
                        taken into account.
                        a suggested value is 0.1 degrees. "
        GLOBAL          off_nom_roll_tune_parms
    END_INSTANCE