A direct translator from neutral model format to the SPARK simulation environment

The neutral model format (NMF) provides generic, machine-readable descriptions of equation-based component models of a physical system in a building description. It is intended to allow model interchange between different simulation environments. The simulation problem analysis and research kernel (SPARK) is a simulation environment that generates source and executable code for solving non-linear differential-algebraic equation systems. It is intended to automate the generation of modular, easy to maintain simulation programs. The goal is to generate simulation code automatically from NMF models transparently to the user. A translator achieving this goal is described here, which transforms NMF syntax into SPARK syntax using LEX and YACC for parsing and numerical inversion techniques generating SPARK code. Thus the practicality of NMF as a common description language for building simulation is demonstrated for the case of a simulation environment developed independently from NMF. The purpose of this paper is to give an account of the experience of building a translator from a general model representation format (NMF) to a particular simulation environment. We first present the NMF format, then the SPARK building simulation environment. Then the 1st translator from NMF to SPARK via a computer algebra system is presented, along with examples. That translator being too circuitous, a newer and direct translator is then presented, along with practical examples. Thus are demonstrated the usefulness of the NMF concept and the methodology for building a translator from it to an independently developed simulation environment for building science.