peakSurfaceFieldMagnitude

peakSurfaceFieldMagnitude

Works with VSimBase, VSimEM, VSimPD, and VSimMD licenses.

Computes the peak magnitude of a field over a grid boundary. The value is stored in a history along with the location. The first element of the history is the peak magnitude of the field, The units of this peak magnitude are expressed in the same the units of the field itself. The next three values represent the x, y and z positions of the peak value, which are expressed in meters. You can use peakSurfaceFieldMagnitude to compute the peak surface current observed on the surface of a device.

In the example that follows for the peakSurfaceFieldMagnitude field history kind, this block computes the maximum magnetic field (H) magnitude over a surface specified by gridBoundary, and records the value along with its position on the surface. The B field in Vorpal is converted to H by using the coefficient parameter. Since the peak H field on a surface corresponds to the peak in the surface current this use of the history can help identify potential locations on a SRF cavity surface where the quenching of the superconductor may occur.

peakSurfaceFieldMagnitude Parameters

alpha (real, default value = 1.0)

Defines the offset distance from the boundary where the field will be measured. Interopolation on the boundary is effected by values in the boundary itself so a more accurate value for the field is achieved by computing the field slightly off the surface. The normal distance from the surface where the field is measured is given by alpha multiplied by the cell hypotenuse.

coefficient (real, optional, default = 1.0)

Coefficient by which the peak magnitude can be multiplied.

field (string, required)

Name of the field whose magnitude is computed at each surface point.

gridBoundary (string, required)

Name of the gridBoundary object over which the peak will be determined.

lowerBounds (integer vector)

Lower bounds of the region for which the peak magnitude calculation is to be performed.

upperBounds (integer vector)

Upper bounds of the region for which the peak magnitude calculation is to be performed.

peakSurfaceFieldMagnitude History Example

<History peakMagneticField>
  kind = peakSurfaceFieldMagnitude
  alpha = 1.0
  coefficient = $1/MU0$ # Converts B to H
  gridBoundary = cylindricalCav
  field = multiField.magField
</History>