Components

Architecture documentation section of TMC Suite. Package contents: 6 static libraries and 6 programs, the responsibility of each component, the location of the sources and the project files.

The package consists of 6 libraries (static .lib) and 6 programs (executable .exe). The programs fall into three groups: viewers, compute kernels, and the FieldView field visualizer.

1. Libraries (static .lib)

Libraries are reusable code with no entry point. Each is built independently as a StaticLibrary for Win32 and x64.

The shared headers of the libraries and programs live in src/Include/ (for example, COMPLEX1.H, Typedef.h, Typerth.h, Tmcgrviw.h).

Brief explanations

• SFILE95 — the central data-exchange library. The S-file (scattering matrix) is the main format the programs exchange with each other. It is read by both viewers and kernels.
• complex — complex-number arithmetic in C style (functions over the _complex structure, without operator overloading). Needed for working with S-matrices and fields.
• exprint — parsing of string expressions (for example, formulas in the input data) and their evaluation.
• TMCLibError — a single mechanism for capturing and passing errors between layers.
• PREPR — a preprocessor that expands macros in the input files before computation.
• TMCIndan — induced-current computation and handling of the planar-structure topology (used by the compute kernels).

2. Programs — viewers

Viewers are MFC applications for viewing and processing computation results. They do not compute the field; they display and transform finished data.

3. Programs — compute kernels

The compute kernels are computation modules. They read the description of the structure/topology, perform the electrodynamic computation, and produce output files.

X-mode is built from the same sources, but with 6 preprocessor macros set in the project properties (C/C++ → Preprocessor → Preprocessor Definitions): ELECTRON_Q___, ELECTRON_M___, CTMCRTH_INDANBLCK_FILEY, CTMCRTH_INDANBLCK_RECTSTATY, CTMCRTH_INDANBLCK_CIRCSTATY, CTMCRTH_INDANBLCK_POLYGSTTY. The macros are not added to the shared headers.

4. Program — FieldView

FieldView is the only program in the package that uses OpenGL (opengl32, glu32) for three-dimensional visualization.

5. Summary diagram of contents

TMC Suite
├── Libraries (.lib)
│   ├── SFILE95       — S-files (read/write)
│   ├── complex       — complex arithmetic
│   ├── exprint       — expression parsing
│   ├── TMCLibError   — error handling
│   ├── PREPR         — macro preprocessor
│   └── TMCIndan      — induced currents / topology
│
├── Viewers (.exe)
│   ├── TMCGROUT      — S-matrix frequency responses
│   ├── TMCROS        — time signals, time→S
│   └── TMC_DN        — radiation patterns
│
├── Compute kernels (.exe)
│   ├── PlanarRT_H    — H-polarization  (tmc_rth.exe)
│   └── PlanarRT_X    — X-mode          (tmc_rtx.exe, 6 macros)
│
└── FieldView (.exe)  — field visualization (OpenGL)