Syntax highlighting and object auto-completion for EnergyPlus and Modelkit files
If the package installation process within Atom isn't working, you can install manually instead. First, save this package's folder to a local directory and NOT a shared directory.
Open a command window in the "atom-energyplus-package" directory you saved in the first step and type the command 'apm link'. If that doesn't work, you may need to add Atom's 'apm' to your Path variable (see below) and try the command again.
Once 'apm link' works, you should be able to view a new folder for this package in your primary Atom packages folder (see below).
This package leverages snippets to auto-complete EnergyPlus objects with input fields set to default values. Input fields that do not have default values and require user input are auto-completed with "???".
This package also leverages snippets to auto-complete typical code blocks used in Modelkit projects. Code block components that require user input are auto-completed with "???".
To use EnergyPlus snippets, type in the object class name, then select the appropriate object class name preceded by the green snippets arrow by clicking on it or using arrow keys to highlight the object and then hit the Tab or Enter key. At the bottom of the auto-complete window, you will be able to see a description of what that object represents in the building energy model. This description is taken from the EnergyPlus Input Data Dictionary (IDD) file. At the end of that description is a URL labeled
More .., which is a link to the web-based EnergyPlus Input-Output Reference documentation for that object. The gif below shows an example of using snippets to generate a
Building object, as well as how to access web-based documentation for the
To use Modelkit snippets, type in the initial characters of the code black you want to insert. Select the appropriate snippet in the auto-complete window the same way you would for an EnergyPlus snippet. Note that in order to view the Modelkit snippets beginning with "<%" in the auto-complete window, you must check the "Enable Extended Unicode Support" box in the settings for the 'autocomplete-plus' package that comes with Atom. Also note that the auto-complete window will disappear if you include "%".
This package leverages three grammar CSON files (e.g.
styles/language-idf.less) defines what text color and background highlighting formats to apply to some of those text categories. For example, EnergyPlus object class names (keyword.object.class.idf) appear in blue, bold text and the final line in ERR files will either have green background highlighting if the most recent simulation succeeded (entity.warning.idf) or red background highlighting if the most recent simulation terminated (variable.warning.idf). The grammar CSON files and styles LESS file can be reconfigured, if you desire.
All files copyright (c) 2017 - 2018 Big Ladder Software. All rights reserved.
See the file LICENSE.md.
Good catch. Let us know what about this package looks wrong to you, and we'll investigate right away.