QuickField Data Builder

QuickField Data Builder is a lightweight utility that interacts with QuickField installed on the same computer and automatically generates QuickField data files from a script file (.qfd).

A .qfd script is a plain-text UTF-8 JSON Lines file: one JSON object per line. It can be called by QuickField Problem Builder through the dataBuilder command, or it can be run standalone.

The program is written in Python, and both the source code and a precompiled executable are available for download from the QuickField website.

The complete command reference is available as a PDF.
Documentation version: 0.4.2; QFD format: 1.1.

QF DataBuilder full instruction (PDF)

Data Builder can be started with or without command-line parameters:
data_builder.exe [/h] [filepath]

/h - displays a list of supported script commands

filepath - loads the specified .qfd script

If data_builder.exe is launched without parameters, it opens a graphical user interface where the user can choose a script file manually.

All processed commands are logged into the data_builder.log file.

QuickField Data Builder scripts

A Data Builder script (.qfd) is a plain-text UTF-8 JSON Lines file: one JSON object per line.

The script format version is 1.1. The version command must appear before analysis.

Basic script structure:
{"version":"1.1"}
{"analysis":"es"}
{"blockLabel":{"name":"B_Diel","permittivity":4}}
{"edgeLabel":{"name":"E_Gnd","potential":0}}
{"save":"example.des"}

The save command writes the QuickField data file, and the output extension must match the selected analysis type.

Supported analysis codes

Data Builder supports all QuickField data file types listed below. Detailed label fields, examples and validation rules for each analysis are described in the downloadable PDF instruction.

Code	Analysis type	Output data file
`ms`	DC Magnetics / transient magnetic data	`.dms`
`he`	AC Magnetics	`.dhe`
`es`	Electrostatics	`.des`
`dc`	DC Conduction	`.dcf`
`ec`	AC Conduction	`.dec`
`tv`	Transient Electric	`.dtv`
`sa`	Stress Analysis	`.dsa`
`sht`	Steady-State Heat Transfer	`.dht`
`tht`	Transient Heat Transfer	`.dht`

Label commands

Data Builder uses one command family for block, edge and vertex labels:
{"blockLabel":{"name":"LabelName", "...":"..."}}
{"edgeLabel":{"name":"LabelName", "...":"..."}}
{"vertexLabel":{"name":"LabelName", "...":"..."}}

The active analysis command determines which physical label object is created and which properties are valid.

Empty labels are allowed, for example:
{"blockLabel":{"name":"B_Empty"}}

A QuickField formula is passed as:
{"expr":"QuickField formula string"}

Accept terms above and download:
Source code (py) and precompiled (exe)
Full instruction (PDF)