Entity Command

The Entity commands lets you insert XML entity definitions in the file and use then in selected commands.

Introduction

XML entities do not have much function when building and running calculations in NairnFEAMPM or NairnFEAMPMViz. But perhaps you will use NairnFEAMPM or NairnFEAMPMViz just to create the XML input commands and then copy those files to a remote computer for running large calculations. After such calculations, you may need to modify the XML files remotely for new calculations using basic text editors or command line tools (like vi). For these situations, it is helpful have entities in your XML files. The entities will be near the beginnin of the file (and therefore easy to edit) and they can be used throughout the file to control selected options of the simulations.

Input Command

To create an XML entity to appear in automatically-formatted input commands, use the command (which is for scripted files only):

Entity (name),(value)

where

• (name) is the entity name without the leading ampersand (&) or trailing semicolon (;) (e.g, maxTime to refer to an XML entity &maxtime;).
• (value) is the setting for the entity to be inserted in the file.

All entities will appear in the DocType element at the start of the resulting XML commands. For example, the output could be:

<?xml version='1.0'?>
<!DOCTYPE JANFEAInput SYSTEM '/nairn-mpm-fea-OpenMP/NairnMPM/input/NairnMPM.dtd'
[
  <!ENTITY maxtime "7.5">
  <!ENTITY archPath "Results/MPM">
  <!ENTITY archTime "0.1">
]>

Usage

One entities are defined, you can use then in selected commands. For example, the MaximumTime command will accept an entity. Each command that allows an entity will be document as accepting them. To use an entity, give the same name use in the Entity command (i.e., the entity name without the leading ampersand (&) or trailing semicolon (;). The commands that accept entities are all commands intended to accept numerical values.

You can also use entities on most commands that expect string arguments such as the Scripted Input Files|Archive command or any argument that can be a user-defined function.. In this usage, the string you supply is simply used in place of the expected string and therefore you should use the complete entity name including the leading ampersand (&) and trailing semicolon (;). This usage works for many, but nor all, command that accept string arguments. When in doubt, you can test by providing an entity and then checking the results XML to verify the entity was inserted as expected. In addition, the entity you provide is inserted without verify you have actually defined that entity. It is your responbility to make sure they are defined.