ActiveField - QuickField API help

QuickField Student Edition free download     Contacts

ActiveField Technology

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

LabelVertex Object

Properties

Methods

Summary

Set of common physical data of a vertex, which are applicable to all kind of problems.

Details

The LabelVertex object represents very general physical data applicable to a vertex label. When you need to change physical parameters for the vertex label, you get the LabelVertex object using the Content property of the Label object, modify the LabelVertex object using its properties and then put it back in the Label object assigning your LabelVertex to the Content property of your Label object. Please see the example for Label object

The exact type of the LabelVertex object you get by the Label.Content property depends upon the problem type as show in the table:

Kind of Analysis

LabelVertex Type

Electrostatic problem

LabelVertexES

DC conduction problem

LabelVertexCF

AC conduction problem

LabelVertexEC

Transient electric problem

LabelVertexTV

DC and transient magnetics problem

LabelVertexMS

AC magnetics

LabelVertexHE

Heat transfer problem (static and transient)

LabelVertexHT

Stress analysis problem

LabelVertexSA

The generic LabelVertex object provides only those properties that are common for all specific types of LabelVertices. These are:

Type property
as qfVertex
Read-only Returns the qfVertex value showing that the data are applicable to a vertex label.
ProblemType property
as QfProblemTypes
Read-only Returns the problem type.
ConditionType property
as QfBoundaryConditionType
Read-only Returns one of the QfBoundaryConditionType constants indicating the type of boundary condition (Dirichlet, Neumann, and other).
Dirichlet property
as Double
Read and write Sets the given potential value on the vertex.
Loading property
as Double
Read and write Sets the value of concentrated loading on the vertex.
Empty property
as Boolean
Read-only Is True when the data are not given for this object.
SetEmpty Method Makes the LabelVertex empty.

Each LabelVertex's subtype inherits all the methods and properties of the basic LabelVertex type listed above.

Generally a vertex cannot have more than one boundary condition defined. Alternative types returned by the ConditonType property are:

If you set the boundary condition type for a vertex several times, only the last setting is remembered.

The following example iterates through vertex labels in the document and sets the same value as a Dirichlet condition to all Dirichlet vertices, and zero as a concentrated loading for other vertices:

Dim lb As QuickField.Label
    For Each lb In prb.DataDoc.Labels(qfVertex)
    Dim vertexData As LabelVertex
    Set vertexData = lb.Content
    With vertexData
        If .ConditionType = qfDirichlet Then
            .Dirichlet = 200
        Else
            .Loadings = 0
        End If
    End With
    lb.Content = vertexData
Next