PUBLIC INTERFACE / NAMELIST / ERRORS / NOTES


program atmos_model

     Contact:   B. Wyman
     Reviewers:
     Change history: WebCVS Log for solo/atmos_model.f90


OVERVIEW


     A main program for running a very simple, solo atmospheric model.

     This version calls only a very simple atmospheric model interface.
     It may be used as a main program for several stand-alone atmospheric
     models, such as a dry dynamical core with Held-Suarez forcing or
     with shallow water models.





OTHER MODULES USED


       atmosphere_mod
     time_manager_mod
              fms_mod
           mpp_io_mod
     diag_manager_mod
    field_manager_mod
   tracer_manager_mod


PUBLIC INTERFACE


   This is a main program. There are no callable interfaces.

   A namelist interface called &main_nml must reside
   in file input.nml. See the details below.


NAMELIST


&main_nml

  current_time  The time (day,hour,minute,second) that the current
                integration starts with.
                  [integer, dimension(4), default: current_time=0]

  days          The number of days that the current integration will
                be run for.   [integer, default: days=0]

  hours         The number of hours that the current integration will
                be run for.   [integer, default: hours=0]

  minutes       The number of minutes that the current integration will
                be run for.   [integer, default: minutes=0]

  seconds       The number of seconds that the current integration will
                be run for.   [integer, default: seconds=0]


  dt_atmos      Time step in seconds for the atmospheric model.
                Must be specified.
                   [integer, default: dt_atmos=0]

  Notes:

    1) If no value is set for current_time (or default value specified)
       then the value from restart file "INPUT/atmos_model.res" will
       be used. If neither a namelist value or restart file value exist
       the program will fail.

    2) The actual run length will be the sum of days, hours,
       minutes, and seconds.  A run length of zero is not a valid option.


ERROR MESSAGES


FATAL ERRORS in program atmos_model

    ntfamily > 0
        Tracer families are not allowed. Check your field_table.

    dt_atmos has not been specified
        A value must be specified for variable "dt_atmos" in
        namelist &main_nml. See the namelist documentation for details.

    invalid base date - must have year = month = 0
        There is no calendar associated with this model.
        The base date retrieved from the diagnostics manager assumes
        that a year and month exist, this is not allowed.
        Set the base date year and month to zero in diag_table.

    initial time is greater than current time
        If a restart file is present, then the namelist value for either
        current_time or base time (from diag_table) was incorrectly set.

    run length must be multiple of atmosphere time step
        There must be an even number of atmospheric time steps for the
        requested run length.

WARNINGS in program atmos_model

    final time does not match expected ending time
        This error should probably not occur because of checks done at
        initialization time.


KNOWN BUGS


     None.


NOTES


     None.


FUTURE PLANS


     None.