version -- Obtain version information
Synopsis
host$ gridlabd --version
Remarks
The --version command line option is used to display the version of GridLAB-D. The message displayed is actually a concatenation of the major and minor numbers, the patch number, the build number, and the branch name.
Major
The major version of GridLAB-D is changed whenever changes are made to the simulation that are not backward compatible. Changes such as the removal of a class or module, or a substantial change in the implementation that will significantly alter the result of simulation will be made only when major versions are released.
Minor
The minor version of GridLAB-D is changed whenever changes are made that are backward compatible within a major version, but are nonetheless substantive.
Patch
The patch version is changed only when a trivial change or bug fix is released. No other substantive change in simulation results should be expected.
Build
The build number is changed every time a new changeset is incorporated into a build of the simulation. If the build includes a local modification that is not included in the repository, the build number will have the letter "M" appended.
Branch
A new name is assigned to each branch. Names are assigned alphabetically based of WECC [1] 500kV busses. See the History page for details on the branch names.
Version Format
For release builds of GridLAB-D the version information is displayed as follows
host% gridlabd --version GridLAB-D 3.0.0-2746 (Grizzly) ^ ^ ^ ^ ^ | | | | +------- Branch name - Alphabetic sequence named after WECC transmission system buses. | | | +------------ Build number - A unique number that identifies which revision the build is based on. | | +-------------- Path number - A sequence number identifying which patch the version is. | +---------------- Minor version - Identifies the minor version number. Minor versions are backward compatible within a major version. +------------------ Major version - Identifies the major version number. Major versions are not backward compatible with previous major versions.
For development builds the branch information will indicate which code tree base was built and a summary of how it was modified. See svn help status for details on the modification flags.
Example
The version number can be used for conditional tests in GLM files
#if ${version.major}<3 // version 2 code ... #else // version 3 code ... #endif