electrostatic_field
provides an electric field arising from disctretized elements computed with kemfield as initialized with kgeobag. To use this field, a valid geometry must have been constructed in the <geometry> section. The electrostatic field requires exactly one charge density solver for the boundary element method and one field solver. See the charge density solver and field solver elements for the available solvers.
<electrostatic_field>KGElectrostaticBoundaryFieldfield_electrostatic, ksfield_electrostaticElement |
Description |
|---|---|
display the number of discretized surface elements of the geometry on the console before any computation starts. |
|
This solver loads precomputed charge densities from .kbd files. |
|
This solver loads precomputed charge densities from .kbd files. |
|
the explicit superposition cached charge densiy solver computes the superposition field of the different configurations specified in the component elements by adding their scaled charge densities. |
|
the explicit superposition cached charge densiy solver computes the superposition field of the different configurations specified in the component elements by adding their scaled charge densities. |
|
the fast multipole field solver adaptively divides the world cube into smaller cube and computes multipole expansions around the cube center describing the far field for the source elements inside the cube. |
|
uses the gaussian elimination technique to compute charge densities. |
|
uses the gaussian elimination technique to compute charge densities. |
|
performs a sum over all discretized components to obtain the final field. |
|
the old Krylov solver only allows a single level preconditioning but the new Krylov solver cannot store intermediate results to restart after the process has been terminated externally (time limit on server, blackout,…) |
|
the Krylov charge density solver is a solver using Krylov subspace methods to solve the linear charge densities equation. |
|
the old Krylov solver only allows a single level preconditioning but the new Krylov solver cannot store intermediate results to restart after the process has been terminated externally (time limit on server, blackout,…) |
|
the Krylov charge density solver is a solver using Krylov subspace methods to solve the linear charge densities equation. |
|
the old Krylov solver only allows a single level preconditioning but the new Krylov solver cannot store intermediate results to restart after the process has been terminated externally (time limit on server, blackout,…) |
|
the robin hood charge density solver is an iterative linear equation solver. |
|
the robin hood charge density solver is an iterative linear equation solver. |
|
display the times for charge density solving and field solver initialization. |
|
the viewer opens a window and displays the geometry. |
|
uses the zonal harmonic expansion about an axis to compute fields. |
Attribute |
Type |
Description |
|---|---|---|
|
|
name of directory in which to cache computation. No directory should default to the KEMField cache. |
|
|
name of file in which to cache computation. |
|
|
this value is passed to the charge density solver to configure the retrival mechanism for precomputed solutions of the charge density solver. You should not have to use this option. |
|
|
this value is passed to the charge density solver to configure the retrival mechanism for precomputed solutions of the charge density solver. You should not have to use this option. |
|
|
elements with an aspect ratio above this value are ignored in the electric field computation. The aspect ratio of a triangle is the ratio of the longest side over the corresponding height. The aspect ratio of a rectangle is the ratio of the longer side over the shorter side. The aspect ratio of a wire is the length divided by the diameter. |
|
|
elements of the geometry with an area below this value are ignored in the electric field computation |
|
|
the name of the electric field. |
|
|
Refers to KGeoBag spaces (path in the geometry). |
|
|
paths to KGeoBag surfaces which are equipped with both a discretization and electromagnetic properties. Surfaces not fulfilling both criteria are ignored. Refers to KGeoBag surfaces (path in the geometry). |
|
|
may be none, axial or discrete_axial, which constrains methods that may be used in computation. The symmetry is always defined along the z-axis. Values: |
|
|
path to exactly one kgeobag space whose coordinate system the computation will use. Refers to a KGeoBag space (path in the geometry). |
Example:
<electrostatic_field
name="field_electrostatic"
directory="."
file="Electrodes.kbd"
system="assembly"
surfaces="assembly/@electrode_tag"
symmetry="axial"
hash_masked_bits="0"
hash_threshold="1e5"
minimum_element_area="1e-3"
maximum_element_aspect_ratio="1e100"
>
<gaussian_elimination_charge_density_solver/>
<integrating_field_solver/>
</electrostatic_field>
Used as:
<field_electrostatic>in <electric_potentialmap_calculator><ksfield_electrostatic>(deprecated: define fields in the <kemfield> section instead (legacy alias)) in <kassiopeia><electrostatic_field>in <kemfield>
Can be referenced by:
fieldof <electric_potentialmap_calculator>electric_fieldof <ks_simulation>root_fieldof <ramped_electric_field>root_field_1of <ramped_transitional_electric_field>root_field_2of <ramped_transitional_electric_field>
More information
Appears in the documentation:
Fields (Electric fields)
Visualization (Electrode Geometry)
Used in example configurations:
<Kassiopeia/XML/Examples/DipoleTrapMeshedSpaceSimulation.xml>
<Kassiopeia/XML/Examples/VTK/DipoleTrapMeshedSpaceSimulation.xml>
<Kassiopeia/XML/Examples/VTK/PhotoMultiplierTubeSimulation.xml>
KEMField/Source/XML/Examples/ElectricFieldExplicitSuperposition.xml