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

Parametric Simulation Samples

How To: Working with Data

How To: Work with Data

                 

The key object for manipulating material properties, field sources and boundary conditions is a DataDoc object. It represents the Data (Property) document. Each DataDoc object is a member of one of the Documents collections that is accessible by the DataDocs property of the QuickField Application. You can also get a DataDoc object from the Problem. The Problem might have up to two associated DataDoc objects: the primary one is accessible by the DataDoc property and the secondary (if any) can be obtained by the Library property.

Each DataDoc inherits all the properties and methods from its parent IDocument interface, so you can create a new DataDoc, open an existing one, save it to disk and so on. A DataDoc object contains three collection of Label, one per each type of geometric entity: Vertices, Edges and Blocks. The Labels collection manages creating, copying, removing a renaming of the Label objects. The Label object provides the Edit method for editing the label content by the dialog box, and the Content property that allows obtaining and setting the physical data programmatically.

In general the sequence of actions when working with data proceeds as follows:

  • First you get the DataDoc from the QuickField Application or your Problem;
  • Then you navigate through the Labels collection to find the Label you need;
  • Get the data from the Label using the Content property. The exact type of the object returned by the Content property depends upon the problem Type and the type of geometric entity the label is assigned to. It is a derivative from the LabelEdge, LabelBlock or LabelVertex base object.
  • Then you get and/or set your data with the object, returned by the Content property.
  • At last you put the altered object back to the Label by the Content property.
  • Now your DataDoc object is changed and you probably want to save it to the file using the IDocument's method Save or SaveAs.

See the DataDoc topic for the chart and more detailed explanation.