Project SetupΒΆ
To setup a simulation project all .jcm
input files are placed in a common project directory. Input files with the suffix .jcm
have fixed names, that are layout.jcm
, materials.jcm
, sources.jcm
, and boundary_conditions.jcm
. Besides these files the project directory contains one or several project files with suffix .jcmp
. The project files carry user-defined names.
The input files have the following roles:
- layout.jcm: Geometry specification of the considered device. The device is built up from domains carrying individual integer domain identifiers (domain ids). The boundary of the device consists of patches, which are marked with integer boundary identifiers. Mesh quality parameters are also set in this file.
- materials.jcm: Assigns material properties to the physical domains as defined in
layout.jcm
. - boundary_conditions.jcm: Assigns boundary properties to the physical boundaries as defined in
layout.jcm
. Furthermore, the field behavior of the impressed quantities can be characterized for the various boundaries. - sources.jcm: Sets impressed field quantities, i.e., temperature, electric field strength, etc., which may be regarded as the input fields of the simulation.
- project.jcmp.para: Allows to globally define the values of system parameters that can be used in other input files.
- *.jcmp: The project file specifies the simulation problem to be solved (e.g., computation of magnetic field strength of a waveguide mode), as well as numerical parameters. It may further contain a batch of post-process directives, which are needed to extract relevant data from the near-field solution. Typically this input file is named
project.jcmp
.
A simulation session has three phases:
Calling
JCMgeo
with the project directory as argument to create a finite element mesh:>> JCMgeo <ProjectDir>
The meshing tool
JCMgeo
processes the input filelayout.jcm
to generate an additional filegrid.jcm
also placed in the project directory.Calling
JCMsolve
in--solve
mode to run the actual simulation:>> JCMsolve --solve <ProjectFile>
<ProjectFile>
stands for the.jcmp
project file.JCMsolve
reads the input filesgrid.jcm
,materials.jcm
,boundary_conditions.jcm
,sources.jcm
, and the.jcmp
project file. Result files such as afieldbag.jcm
file containing the computed field distributions are placed in the subdirectory<ProjectFile>_results
. After solving the problem,JCMsolve
processes post-process directives contained in<ProjectFile>
.Calling
JCMsolve
in--post_process mode
to run additional post-processes. To extract relevant data one uses additional.jcmp
files<PostProcessFile>
containing post-process directives:>> JCMsolve --post_process <PostProcessFile>