visall
Visualize x-, y-, z-normal slices of a 3D field solution with objects and sources.
Contents
Syntax
visall(scalar3d, [opts]) visall(scalar3d, obj_array, [opts]) visall(scalar3d, obj_array, src_array, [opts])
Description
visall(scalar3d) vizualizes one of the x-, y-, z-components of the E- or H-field stored as an instance of Scalar3d. The field is visualized on x-, y-, z-normal slices, which are shown in 3D as well as in 2D.
visall(..., obj_array) visualizes the objects in obj_array with the slices of a field. The elements of obj_array are instances of Object.
vis2d(..., obj_array, src_array) visualizes the objects and sources in obj_array and src_array with the slices of a field. The elements of src_array are instances of Source.
The optional argument opts is an options structure that controls the behavior of visualization. The allowed fields of opts are explained below. The default values of the fields are shown in brackets {}.
- opts.withgrid: true or {false} to show the grid or not.
- opts.withinterp: {true} or false to interpolate the field or not.
- opts.withpml: true or {false} to show the PML regions or not.
- opts.withabs: true or {false} to show the absolute values of the field or not.
- opts.cscale: positive value that controls the color bar range. Set to values less than 1.0 to saturate colors. The default value is 1.0.
- opts.cmax: another positive value that controls the color bar range; the positive maximum of the color bar range is cscale * cmax. If it is set to NaN, which is the default, then cscale * (maximum amplitude of the plotted data) is used for the maximum of the color bar range.
- opts.isopaque: {true} or false to show opaque slices in 3D or not.
- opts.withobjsrc: true or false to show the objects and sources or not. The default values is true when the number of objects is small (20), but false when the number of objects is large ( 20). To show only sources without objects, provide an empty obj_array in visall().
- opts.phase: additional phase angle phi. The field is visualized with an additional factor exp(i*phi) multiplied. Not useful if opts.withabs = true.
Note
When opts.isopaque = false is used, the 3D view shows the slices nicely with some transparency. However, the 2D views show worse-looking images because the figure renderer that supports transparency interpolates colors differently from the normal renderer.
Example
[E, H, obj_array, src_array] = maxwell_run({ARGUMENTS}); opts.cscale = 1e-1; opts.wihabs = true; visall(E{Axis.x}, obj_array, src_array, opts);