QuickField Data Builder

QuickField Data Builder is a lightweight utility that interacts with QuickField installed on the same computer and automatically generates Data file for DC and Transient Magnetics (.dms) or AC Magnetics (.dhe) analysis by executing commands from a script file (.gfd) in sequence.

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

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 .qfs script

If data_bulider.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) consists of lines in JSON format, in {} brackets.

Supported Commands:

{"version": version_number}

Specifies the command script version. Current version is 1.0

{"open": filePath}

Opens the existing data file

{"save": filePath}

Saves data file

{"analysis": AnalysisType}

Specifies the type of data file. Possible values of AnalysisType are MS, HE which correspond to QuickField DC and Transient magnetics, or AC magnetic output data file formats

{"block_ms": BlockName, ParameterString}

Specifies parameters of a block in DC or Transient Magnetics.

ParameterString may include following parameters, separated by comma:
"mu":[Mux,Muy] - components of magnetic permeability or
"mu":[[B1,H1],[B2,H2],...] - B and H values of the BH-curve points;
"conductivity":[T,Cond] - conductivity Cond at temperature T or
"conductivity":[[T1,Cond1],[T2, Cond2],..] - temperature (in Celsius) аnd conductivity values of the nonlinear conductivity curve points;
"voltage":Value - value of the field source voltage;
"density":Value - value of the field source current density;
"current":Value - value of the field source total current;
"connection":"parallel" - flag of the conductors parallel connection to the field source;
"connection":"serial" - flag of the conductors serial connection to the field source;
"temperature":Value - value of the temperature used for the conductivity calculation.

{"edge_ms": EdgeName, ParameterString}

Specifies parameters of an edge labelled EdgeName in DC or Transient Magnetics.

ParameterString may include following parameters, separated by comma:
"A":Value - value of the magnetic potential;
"Ht":Value - value of the tangential field;
"zeronflux":0 - zero normal flux;
"periodic":"even" - even periodic condition;
"periodic":"odd" - odd periodic condition;

{"vertex_ms": VertexName, ParameterString}

Specifies parameters of a vertex labelled VertexName in DC or Transient Magnetics.

ParameterString may include following parameters, separated by comma:
"A":Value - value of the magnetic potential;
"current":Value - value of the linear current;

{"block_he": BlockName, ParameterString}

Specifies parameters of a block labelled BlockName in AC Magnetics.

ParameterString may include following parameters, separated by comma:
"mu":[Mux,Muy] - components of magnetic permeability or
"mu":[[B1,H1],[B2,H2],...] - B and H values of the BH-curve points;
"conductivity":[T,Cond] - conductivity Cond at temperature T or
"conductivity":[[T1,Cond1],[T2, Cond2],..] - temperature (in Celsius) аnd conductivity values of the nonlinear conductivity curve points;
"voltage":[Value, Phase] - value and phase of the field source voltage;
"density":[Value, Phase] - value and phase of the field source current density;
"current":[Value, Phase] - value and phase of the field source total current;
"connection":"parallel" - flag of the conductors parallel connection to the field source;
"connection":"serial" - flag of the conductors serial connection to the field source;
"temperature":Value - value of the temperature used for the conductivity calculation

{"edge_he": EdgeName, ParameterString}

Specifies parameters of an edge labelled EdgeName in AC Magnetics.

ParameterString may include following parameters, separated by comma:
"A":[Value, Phase] - value and phase of the magnetic potential;
"Ht":[Value, Phase] - value and phase of the tangential field;
"zeronflux":0 - zero normal flux;
"periodic":"even" - even periodic condition;
"periodic":"odd" - odd periodic condition;

{"vertex_he": VertexName, ParameterString}

Specifies parameters of a vertex labelled VertexName in AC Magnetics.

ParameterString may include following parameters, separated by comma:
"A":[Value, Phase] - value and phase of the magnetic potential;
"current":[Value, Phase] - value and phase of the linear current;

Accept terms above and download:
Source code (py-file)
Precompiled (exe-file)