ActiveField™ - QuickField API Help

QuickField Student Edition free download     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




What's New in ActiveField 6.2

Comparing to previous version, QuickField 6.2 has following new features:

  1. New object LabelBlockHE properties for setting and reading the core loss formula parameters.
  2. Possibility to calculate integrals using custom user-defined formula.
  3. Additional methods of the Quantity object, which are related to the custom user-defined formula integration.

Block label properties in the AC Magnetic problem

List of the object LabelBlockHE properties, which correspond to the physical parameters of the block in AC Magnetic problems, are expanded by magnetic core loss coefficients kh, kc, ke in the equation

p = khf B2 + kcf2 B2 + ke(f B)1.5

which is used for calculation of the specific power losses in the laminated core made from the soft magnetic material.

To read/seat corresponding coefficients new properties are added: LossHysteresis for kh coefficient, LossEddy for kc coefficient, LossExcess for ke coefficient. These properties are optional, and their default zero value means that the corresponding loss component is not calculated for materials with this label.

Custom user-defined integrals calculation

During the result analysis QuickField can calculate the integral physical parameters using selection of the predefined formulas. Access to these integrals may be performed via screen user interface, as well as programmatically, by calling the methods GetIntegral or GetIntegralTotal of the Result object. QuickField 6.2 includes not only the standard integrals, but also custom user-defined integrals, i.e. integrals calculated using the formulas, which should be defined by the QuickField user.

User-defined integrals may be accessed in QuickField 6.2 through application programming interface, by calling one of new methods GetCustomIntegral or GetCustomIntegralTotal of the Result object. The first one calculates the integral along the line of side surface, created by the linear contour, or, when the contour is closed, able to calculate the integral over the surface created by the closed contour or over the corresponding volume. The last method calculates the integral over the surface (volume) of the whole calculation region.

Each of these three custom integral calculation methods receive the pointer to the integrate function as a parameter. Custom function is an object which implements the interface UserFunction, defined in the QuickField type library. The method GetValue of the interface UserFunction should be programmed. Syntax rules of the custom function programming are dependent of the specific programming language used. Examples of the custom functions are implemented in C# and Visual Basic for Application (VBA) as Microsoft Excel macros.

Integration is performed in 2D space of the real vectors, and in case of frequency domain (AC magnetic or AC conduction problems) - in 2D space of complex vectors. Integrand expression may be of different nature: real number, real vector, complex number, complex vector etc. By implementing the method GetValue of UserFunction interface, the return value will be the Quantity object, which works as a container for keeping the objects of various nature uniformly.

Visial Basic (VBA) and C# examples of the user-defined integral are provided in the UserFunction object description.

The Quantity object was previously used for storing the calculated integral value, and all its properties were read-only. To assure possibility to save the calculated value of the integrand in the Quantity object several new methods were added.

New methods of the Quantity object

Methods which set the type and value of the Quantity object are mostly designed for implementation of the user-defined function, i.e. method GetValue of the UserFunction interface.




SetAsScalar method with a real type parameter

Assigns the real type value to the object. Quantity type is qfScalar.

SetAsVector method with two real type parameters

Assigns the value of the Point (2D real vector) type to the object. Quantity type is >>

SetAsComplex method with two real type parameters

Assigns the value of the ComplexValue type to the object. Quantity type is >>

SetAsComplexVector method with four real type parameters

Assigns the value of the ComplexVector type to the object. This type defines a complex vector, 2D vector where both x and y components are complex numbers. Quantity type is >>

SetAsOscillated method with three real type parameters

Assigns the value of the OscillatedValue type to the object, This type defines the scalar physical quantity, which oscillates with double frequency and having non-zero average value per period. Quantity type is qfOscillatedValue.

SetAsOscillatedVector method with six real type parameters

Assigns the value of the OscillatedVector type to the object.This type defines the vector physical quantity, which oscillates with double frequency and having non-zero average value per period. Quantity type is qfOscillatedVector.