Auxiliary Programs — EnergyPlus 9.3

<< Prev | Table of Contents | Next >>

IDD Conventions[LINK]

The following is a basic description of the structure of the IDD (it’s actually taken directly from the IDD file). As noted within, ! signifies a comment character as does the \. \ has also been adopted as a convention for including more specific comments about each field in an object. These have been used with success in the IDFEditor and it is hoped the flexibility will provide other interface developers with useful information.

! Object Description
! ------------------
! To define an object (a record with data), develop a key word that is unique
! Each data item to the object can be A (Alphanumeric string) or N (numeric)
! Number each A and N.  This will show how the data items will be put into the
! arrays that are passed to the Input Processor "Get" (GetObjectItem) routines.
! All alpha fields are limited to 100 characters.  Numeric fields should be
! valid numerics (can include such as 1.0E+05) and are placed into double
! precision variables.
!
! NOTE: Even though a field may be optional, a comma representing that field
!   must be included (unless it is the last field in the object).  Since the
!   entire input is "field-oriented" and not "keyword-oriented", the EnergyPlus
!   Input Processor must have some representation (even if blank) for each
!   field.
!
! Object Documentation
! --------------------
! In addition, the following special comments appear one per line and
! most are followed by a value.  Comments may apply to a field or the object
! or a group of objects.
!
! Field-level comments:
!
!  \field           Name of field
!                     (should be succinct and readable, blanks are encouraged)
!
!  \note            Note describing the field and its valid values
!
!  \required-field  To flag fields which may not be left blank
!                     (this comment has no "value")
!
!  \begin-extensible  Marks the first field at which the object accepts an extensible
!                   field set.  A fixed number of fields from this marker define the
!                   extensible field set, see the object code \extensible for
!                   more information.
!
!  \units           Units (must be from EnergyPlus standard units list)
!                   EnergyPlus units are standard SI units
!
!  \ip-units        IP-Units (for use by input processors with IP units)
!                   This is only used if the default conversion is not
!                   appropriate.
!
!  \unitsBasedOnField  For fields that may have multiple possible units, indicates
!                   the field in the object that can be used to determine
!                   the units. The field reference is in the A2 form.
!
!  \minimum         Minimum that includes the following value
!
!  \minimum>        Minimum that must be > than the following value
!
!  \maximum         Maximum that includes the following value
!
!  \maximum<        Maximum that must be < than the following value
!
!  \default         Default for the field (if N/A then omit entire line)
!
!  \deprecated      This field is not really used and will be deleted from the object.
!                   The information is gotten internally within the program.
!
!  \autosizable     Flag to indicate that this field can be used with the Auto
!                   Sizing routines to produce calculated results for the
!                   field.  If a value follows this, then that will be used
!                   when the "Autosize" feature is flagged.  To trigger
!                   autosizing for a field, enter Autosize as the field's
!                   value.  Only applicable to numeric fields.
!
! \autocalculatable Flag to indicate that this field can be automatically
!                   calculated. To trigger auto calculation for a field, enter
!                   Autocalculate as the field's value.  Only applicable to
!                   numeric fields.
!
!  \type            Type of data for the field -
!                     integer
!                     real
!                     alpha       (arbitrary string),
!                     choice      (alpha with specific list of choices, see
!                                 \key)
!                     object-list (link to a list of objects defined elsewhere,
!                                  see \object-list and \reference)
!                     node        (name used in connecting HVAC components)
!
!  \retaincase      Retains the alphabetic case for alpha type fields
!
!  \key             Possible value for "\type choice" (blanks are significant)
!                     use multiple \key lines to indicate all valid choices
!
!  \object-list     Name of a list of user-provided object names that are valid
!                     entries for this field (used with "\reference")
!                     see Zone and BuildingSurface:Detailed objects below for
!                     examples.
!                  ** Note that a field may have multiple \object-list commands.
!
!  \reference       Name of a list of names to which this object belongs
!                     used with "\type object-list" and with "\object-list"
!                     see Zone and BuildingSurface:Detailed objects below for
!                     examples:
!
!                        Zone,
!                          A1 , \field Name
!                               \type alpha
!                               \reference ZoneNames
!
!                        BuildingSurface:Detailed,
!                          A4 , \field Zone Name
!                               \note Zone the surface is a part of
!                               \type object-list
!                               \object-list ZoneNames
!
!             For each zone, the field "Name" may be referenced
!             by other objects, such as BuildingSurface:Detailed, so it is
!             commented with "\reference ZoneNames"
!             Fields that reference a zone name, such as BuildingSurface:Detailed's
!             "Zone Name", are commented as
!             "\type object-list" and "\object-list ZoneNames"
!             ** Note that a field may have multiple \reference commands.
!             ** This is useful if the object belongs to a small specific
!             object-list as well as a larger more general object-list.
!
! Object-level comments:
!
!  \memo            Memo describing the object
!
!  \unique-object   To flag objects which should appear only once in an idf
!                     (this comment has no "value")
!
!  \required-object To flag objects which are required in every idf
!                     (this comment has no "value")
!
!  \min-fields      Minimum number of fields that should be included in the
!                   object.  If appropriate, the Input Processor will fill
!                   any missing fields with defaults (for numeric fields).
!                   It will also supply that number of fields to the "get"
!                   routines using blanks for alpha fields (note -- blanks
!                   may not be allowable for some alpha fields).
!
!  \obsolete        This object has been replaced though is kept (and is read)
!                   in the current version.  Please refer to documentation as
!                   to the dispersal of the object.  If this object is
!                   encountered in an IDF, the InputProcessor will post an
!                   appropriate message to the error file.
!                   usage:  \obsolete New = >[New object name]
!
!  \extensible:<#>  This object is dynamically extensible -- meaning, if you
!           change the IDD appropriately (if the object has a simple list
!           structure -- just add items to the list arguments (i.e. BRANCH
!           LIST). These will be automatically redimensioned and used during
!           the simulation. <#> should be entered by the developer to signify
!           how many of the last fields are needed to be extended (and EnergyPlus
!           will attempt to auto-extend the object).  The first field of the first
!           instance of the extensible field set is marked with \begin-extensible.
!
!  \begin-extensible See previous item, marks beginning of extensible fields in
!                   an object.
!
!  \format          The object should have a special format when saved in
!                   the IDF Editor with the special format option enabled.
!                   The options include SingleLine, Vertices, CompactSchedule,
!                   FluidProperties, ViewFactors, and Spectral.
!                   The SingleLine option puts all the fields for the object
!                   on a single line. The Vertices option is used in objects
!                   that use X, Y and Z fields to format those three fields
!                   on a single line.
!                   The CompactSchedule formats that specific object.
!                   The FluidProperty option formats long lists of fluid
!                   properties to ten values per line.
!                   The ViewFactor option formats three fields related to
!                   view factors per line.
!                   The Spectral option formats the four fields related to
!                   window glass spectral data per line.
!
!   \reference-class-name Adds the name of the class to the reference list
!                   similar to \reference.
!
! Group-level comments:
!
!  \group          Name for a group of related objects
!
!
! Notes on comments
! -----------------
!
! 1.  If a particular comment is not applicable (such as units, or default)
! then simply omit the comment rather than indicating N/A.
!
! 2.  Memos and notes should be brief (recommend 5 lines or less per block).
! More extensive explanations are expected to be in the user documentation
!
! Default IP conversions (no \ip-units necessary)
!     m                      = >   ft                  3.281
!     W                      = >   Btu/h               3.412
!     m3/s                   = >   ft3/min             2118.6438
!     C                      = >   F                   1.8 (plus 32)
!     kg/J                   = >   lb/Btu              2325.83774250441
!     Pa                     = >   psi                 0.0001450377
!     W/m-K                  = >   Btu-in/h-ft2-F      6.93481276005548
!     W/K                    = >   Btu/h-F             1.8987
!     deltaC                 = >   deltaF              1.8
!     m2                     = >   ft2                 10.764961
!     K                      = >   R                   1.8
!     1/K                    = >   1/R                 0.555555556
!     (kg/s)/W               = >   (lbm/sec)/(Btu/hr)  0.646078115385742
!     J/kg                   = >   Btu/lb              0.00042986 (plus 7.686)
!     kg-H2O/kg-air          = >   lb-H2O/lb-air       1
!     kJ/kg                  = >   Btu/lb              0.429925
!     lux                    = >   foot-candles        0.092902267
!     kg/m3                  = >   lb/ft3              0.062428
!     kg/s                   = >   lb/s                2.2046
!     kg/s-m                 = >   lb/s-ft             0.67194
!     m3                     = >   ft3                 35.319837041
!     m3                     = >   gal                 264.172
!     W/m2-K                 = >   Btu/h-ft2-F         0.176110194261872
!     1/m                    = >   1/ft                0.304785126485827
!     J/kg-K                 = >   Btu/lb-F            0.000239005736137667
!     J/m3-K                 = >   Btu/ft3-F           1.49237004739337E-05
!     m/s                    = >   ft/min              196.86
!     m/s                    = >   miles/hr            2.2369
!     m2-K/W                 = >   ft2-F-hr/Btu        5.678263
!     W/m2                   = >   Btu/h-ft2           0.316957210776545
!     A/K                    = >   A/F                 0.555555555555556
!     g/kg                   = >   grains/lb           7.00000
!     g/m-s                  = >   lb/ft-s             0.000671968949659
!     g/m-s-K                = >   lb/ft-s-F           0.000373574867724868
!     J/K                    = >   Btu/F               0.000526917584820558
!     J/kg-K2                = >   Btu/lb-F2           0.000132889924714692
!     J/m3                   = >   Btu/ft3             2.68096514745308E-05
!     kg/kg-K                = >   lb/lb-F             0.555555555555556
!     kPa                    = >   psi                 0.145038
!     kPa                    = >   inHg                0.29523
!     m2/s                   = >   ft2/s               10.764961
!     m3/kg                  = >   ft3/lb              16.018
!     m3/m3                  = >   ft3/ft3             1
!     N-s/m2                 = >   lbf-s/ft2           0.0208857913669065
!     V/K                    = >   V/F                 0.555555555555556
!     W/m-K2                 = >   Btu/h-F2-ft         0.321418310071648
!     m3/s-m                 = >   ft3/min-ft          645.89
!     J/m2-K                 = >   Btu/ft2-F           4.89224766847393E-05
!     cycles/hr              = >   cycles/hr           1
!     kg/kg                  = >   lb/lb               1
!     J/J                    = >   Btu/Btu             1
!     g/GJ                   = >   lb/MWh              0.00793664091373665
!     L/GJ                   = >   gal/kWh             0.000951022349025202
!     m3/GJ                  = >   ft3/MWh             127.13292
!     m3/s-m2                = >   ft3/min-ft2         196.85
!     m3/s-person            = >   ft3/min-person      2118.6438
!     W/m2-K2                = >   Btu/h-ft2-F2        0.097826
!     g/MJ                   = >   lb/MWh              7.93664091373665
!     L/MJ                   = >   gal/kWh             0.951022349025202
!     m3/MJ                  = >   ft3/kWh             127.13292
!     W/W                    = >   Btuh/Btuh           1
!     $/m2                   = >   $/ft2               0.0928939733269818
!     $                      = >   $                   1
!     $/kW                   = >   $/(kBtuh/h)         0.293083235638921
!     $/m3                   = >   $/ft3               0.0283127014102352
!     years                  = >   years               1
!     $/(W/K)                = >   $/(Btu/h-F)         0.52667614683731
!     $/(m3/s)               = >   $/(ft3/min)         0.000472000059660808
!     W/m                    = >   Btu/h-ft            1.04072
!     K/m                    = >   F/ft                0.54861322767449
!     W/s                    = >   W/s                 1
!     kmol                   = >   kmol                1
!     J                      = >   Wh                  0.000277777777777778
!     GJ                     = >   ton-hrs             78.9889415481832
!     kg/m2                  = >   lb/ft2              0.204794053596664
!     kg                     = >   lb                  2.2046
!     percent/K              = >   percent/F           0.555555555555556
!     kg/s2                  = >   lb/s2               2.2046
!     g/mol                  = >   lb/mol              0.0022046
!     deltaJ/kg              = >   deltaBtu/lb         0.0004299
!     person/m2              = >   person/ft2          0.0928939733269818
!     m2/person              = >   ft2/person          10.764961
!     W/person               = >   Btu/h-person        3.412
!     m3/person              = >   ft3/person          35.319837041
!     m3/hr-person           = >   ft3/hr-person       35.319837041
!     m3/m2                  = >   ft3/ft2             3.281
!     m3/hr-m2               = >   ft3/hr-ft2          3.281
!     m3/hr                  = >   ft3/hr              35.319837041
!     s/m                    = >   s/ft                0.304785126485827
!     m2/m                   = >   ft2/ft              3.281
!     L/day                  = >   pint/day            2.11337629827348
!     L/kWh                  = >   pint/kWh            2.11337629827348
!     kg/Pa-s-m2             = >   lb/psi-s-ft2        1412.00523459398
!     m/hr                   = >   ft/hr               3.281
!     Mode                   = >   Mode                1
!     Control                = >   Control             1
!     Availability           = >   Availability        1
!     rev/min                = >   rev/min             1
!     W/(m3/s)               = >   W/(ft3/min)         0.0004719475
!     VA                     = >   VA                  1
!     N-m                    = >   lbf-in              8.85074900525547
!     m3/s-W                 = >   ft3-h/min-Btu       621.099127332943
!     cm2                    = >   inch2               0.15500031000062
!     kg/m                   = >   lb/ft               0.67196893069637
!     m/yr                   = >   inch/yr             39.37
!
! Other conversions supported (needs the \ip-units code)
!
!     m                      = >   in                  39.37
!     W                      = >   W                   1
!     m3/s                   = >   gal/min             15852
!     m3/s                   = >   lbH2O/hr            7936289.998
!     Pa                     = >   inHg                0.00029613
!     Pa                     = >   inH2O               0.00401463
!     Pa                     = >   ftH2O               0.00033455
!     W/person               = >   W/person            1
!     W/m2                   = >   W/m2                1
!     W/m2                   = >   W/ft2               0.0928939733269818
!     W/m-K                  = >   Btu/h-ft-F          0.577796066000163
!
! Units fields that are not translated
!     deg
!     hr
!     A
!     dimensionless
!     V
!     ohms
!     A/V
!     eV
!     percent
!     s
!     W/m2 or deg C
!     W/m2, W or deg C
!     minutes
!     1/hr
! **************************************************************************