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




DataDoc Object




The data description document.


Represents a Data (Property) document. The DataDoc object is a member of the Documents collection that is available by the DataDoc property of the Application object. That collection contains all the DataDoc objects currently opened in QuickField. You can also get the primary DataDoc objects associated with the problem using the DataDoc property of the Problem object, or the secondary (library) one by the Library property.

Property Description or Data documents are specific to types of analysis (Electrostatics data, Stress Analysis data, etc.) These documents store the values of material properties, loadings and boundary conditions for different part labels. The Data document can be used as a material library for many different problems.

The DataDoc object inherits all the properties and methods of the generic Document class. Please see the IDocument class description to learn how to create a new data document or open an existing one, manage document's windows and other related topics.

The DataDoc contains Labels, divided into three collections:

DataDoc Object Collection Labels Collection Labels Collection Labels LabelBlockES Object>>LabelEdgeES Object>>LabelVertexES Object LabelBlockCF Object>>LabelEdgeCF Object>>LabelVertexCF Object LabelBlockEC Object>>LabelEdgeEC Object>>LabelVertexEC Object>> LabelBlockMS Object>>LabelEdgeMS Object>>LabelVertexMS Object LabelBlockHE Object>>LabelEdgeHE Object>>LabelVertexHE Object LabelBlockHT Object>>LabelEdgeHT Object>>LabelVertexHT Object LabelBlockSA Object>>LabelEdgeSA Object>>LabelVertexSA Object Spline Object Elast Object Vector3D Object Spring Object LinFunc Object

Each Label has an associated object containing physical data for it. It is accessible by the Content property of the Label object. The exact type of that object depends upon both the ProblemType and the Label's Type. In such situations when you do not need very specific details of physical data, you can use a generalized type of the label content object. These are: LabelBlock for block label, LabelEdge for edge label and LabelVertex for vertex label content.

The following example opens the "Magn1" problem and counts the labels of different types in the associated data document:

Dim prb As QuickField.Problem
Set prb = QF.Problems.Open(magn1.pbm)
Dim PropDoc As QuickField.DataDoc
Set PropDoc = prb.DataDoc
nBlockLabels = PropDoc.Labels(qfBlock).Count
nEdgeLabels = PropDoc.Labels(qfEdge).Count
nVertexLabel = PropDoc.Labels(qfVertex).Count