ActiveField™ Help

Main QuickField Site     Free Downloads     Contacts

ActiveField Technology
What's New
Objects Overview
Hierarchy Chart
How to Start: Application Object
How to work with Problems
How to work with Model
How to work with Data
How to Analyze Results

Objects

Properties

Methods

FieldPicture Object

Properties

Methods

Summary

Contains properties that control the field presentation in a FieldWindow.

Details

The FieldPicture object contains properties that control the field presentation in a FieldWindow. You can consider FieldPicture as a programmatic analog of the Field Picture dialog box. To modify the picture you have to get a FieldPicture object by PictureSettings property, set desired values to its properties and than put it back to the FieldWindow object.

For most of the field presentation methods the FieldPicture object offers two properties:

ColorMap property returns or sets the field quantity presented by the color map as QfQuantity. If no color map is displayed ColorMap returns qfNothing = -1.

ColorGrades property sets and returns the number of color grades used for the color map is Integer. ColorGrades value should be more then two.

ColorScale (which as QfMinMax) property sets or returns the upper (if which is equal to qfMax) or lower (if which = qfMin) borders of the displayed value range as Double.

Vectors property returns or sets the field quantity displayed as the family of vectors. If no vectors are displayed Vectors is equal to qfNothing = -1.

VectorScale property sets or returns the scale factor of the vectors family as Double.

Cell property sets or returns the cell size for vector, tensor and shape plot.

Equilines property returns or sets the flag indicates whether filed lines (lines of equal potential) are displayed as Boolean.

EquScale property sets or returns the scale value of the field lines family as Double.

Mesh property returns or sets the flag indicates whether the finite element mesh is displayed as Boolean.

For Stress Analysis Problems

Shape property returns or sets the flag indicates whether deformed shape are displayed for a stress analysis problem as Boolean.

ShapeScale property sets or returns the dimensionless scale factor of the deformed shape as Double.

Boundary property returns or sets the flag indicates whether deformed boundary is displayed for a stress analysis problem as Boolean.

Tensors property returns or sets the field quantity (as QfQuantity) displayed as the family of tensors (stress or strain). If no vectors are displayed Tensors is equal to qfNothing = -1.

TensorScale property sets or returns the scale value of the tensors family as Double.

For Time-Harmonic Magnetic Problems

Vectors90 and Equilines90 properties return or set Boolean flags that switch on and off displaying the alternative set of vectors and equilines. These are plot by phase value 90 degree (one firth of period later than the main set).

The following example displays the picture with a color map of the temperature and heat flux density vectors

Dim resWin As FieldWindow

Set resWin = res.Windows(1)
Dim pict As QuickField.FieldPicture
Set pict = resWin.PictureSettings
With pict
    .ColorMap = qfPotential
    .ColorGrades = 200
    .ColorScale(qfMin) = 0
    .ColorScale(qfMax) = 100

    .Vectors = qfKGrad
    .Cell = 5
    .VectorScale = 0.001
End With
resWin.PictureSettings = pict