CIRCU124


Electric Circuit

Valid Products: Pro | Premium | Enterprise | PrepPost | Solver | AS add-on

CIRCU124 Element Description

CIRCU124 is a general circuit element applicable to circuit simulation. The element has up to 6 nodes to define the circuit component and one or two degrees of freedom per node to model the circuit response.

CIRCU124 can be directly coupled to the electromagnetic or stranded coil analysis options of PLANE233, SOLID236, and SOLID237 through the VOLT degree of freedom.

For electric circuit applications (KEYOPT(3) = 0), CIRCU124 is applicable to static, harmonic, and transient analyses. For acoustic equivalent circuit applications (KEYOPT(3) = 1), CIRCU124 is applicable to harmonic and transient analyses.

CIRCU124 Input Data

The geometry, node definition, and degree of freedom options are shown in Figure 124.1: CIRCU124 Circuit Element Options (circuit components) and Figure 124.2: CIRCU124 Circuit Source Options (circuit source options). The element is defined by active and passive circuit nodes. Active nodes are those connected to an overall electric circuit, and passive nodes are those used internally by the element and not connected to the circuit.

Element circuit components and sources are defined by KEYOPT(1) settings and its corresponding real constants. Real constant input is dependent on the element circuit option used. A summary of the element input options is given in "CIRCU124 Input Summary". Real constants numbers 15 and 16 are created by the GUI Circuit Builder (see the Modeling and Meshing Guide), and are not required input for analysis purposes. The element is characterized by these degrees of freedom:

  • VOLT (voltage) - KEYOPT(3) = 0

  • CURR (current)

Figure 124.1: CIRCU124 Circuit Element Options

CIRCU124 Circuit Element Options


Figure 124.2: CIRCU124 Circuit Source Options

CIRCU124 Circuit Source Options


Independent voltage and current sources (KEYOPT(1) = 3 or 4) may be excited by AC/DC, sinusoidal, pulse, exponential, or piecewise linear load functions as defined by KEYOPT(2); see Figure 124.3: Load Functions and Corresponding Real Constants for Independent Current and Voltage Sources.

The time-step size for a transient analysis is controlled by the DELTIM or NSUBST commands. The CIRCU124 element does not respond to automatic time stepping (AUTOTS command), but AUTOTS can be used as a mechanism for ramping the time step to its final value. For coupled electromagnetic-circuit problems, automatic time stepping may be used if controls are placed on degrees of freedom other than VOLT or CURR, or loads associated with those degrees of freedom.

For problems using the CIRCU124 element, the sparse direct solver is chosen by default.

CIRCU124 Input Summary

Nodes

I, J, K, L, M, N

Degrees of Freedom

VOLT, CURR (see Figure 124.1: CIRCU124 Circuit Element Options), PRES

Real Constants

R, L, C, I, V, (blank), (blank), K, G, E, H, F

Dependent on KEYOPT(1) and KEYOPT(2) settings. See Table 124.1: CIRCU124 Real Constants for details.

In a full harmonic analysis (ANTYPE,HARMIC and HROPT,FULL), real constants R, L, and C can be defined as table parameters using the frequency as the primary variable (Var1 = FREQ on the *DIM command).

In a full transient analysis (ANTYPE,TRANS and TRNOPT,FULL), real constants R, L, and C can be defined as table parameters using time as the primary variable (Var1 = TIME on the *DIM command).

Material Properties

None

Surface Loads

None

Body Loads

See KEYOPT(2)

Special Features

None

KEYOPT(1)

Circuit component type:

0 -- 

Resistor

1 -- 

Inductor

2 -- 

Capacitor

3 -- 

Independent Current Source

4 -- 

Independent Voltage Source

8 -- 

Mutual Inductor

9 -- 

Voltage-Controlled Current Source

10 -- 

Voltage-Controlled Voltage Source

11 -- 

Current-Controlled Voltage Source

12 -- 

Current-Controlled Current Source

KEYOPT(2)

Body loads available if KEYOPT(1) = 3 or 4:

0 -- 

DC or AC Harmonic load

1 -- 

Sinusoidal load

2 -- 

Pulse load

3 -- 

Exponential load

4 -- 

Piecewise Linear load

KEYOPT(3)

Circuit type:

0 -- 

Electrical circuit with the VOLT degree of freedom

Table 124.1: CIRCU124 Real Constants

Circuit Option and Graphics LabelKEYOPT(1)Real Constants
Resistor (R)0R1 = Resistance (RES)
Inductor (L)1
R1 = Inductance (IND)
R2 = Initial inductor current (ILO)
Capacitor (C)2
R1 = Capacitance (CAP)
R2 = Initial Capacitor Voltage (VCO)
Mutual Inductor (K)8
R1 = Primary Inductance (IND1)
R2 = Secondary Inductance (IND2)
R3 = Coupling Coefficient (K)
Independent Current Source (I)3For KEYOPT(2) = 0:
R1 = Amplitude (AMPL)
R2 = Phase angle (PHAS)
For KEYOPT(2) > 0: see Figure 124.3: Load Functions and Corresponding Real Constants for Independent Current and Voltage Sources.
Voltage-Controlled Current Source (G)9R1 = Transconductance (GT)
Current-Controlled Current Source (F)12R1 = Current Gain (AI)
Independent Voltage Source (V)4For KEYOPT(2) = 0:
R1 = Amplitude (AMPL)
R2 = Phase angle (PHAS)
For KEYOPT(2) > 0: see Figure 124.3: Load Functions and Corresponding Real Constants for Independent Current and Voltage Sources.
Voltage-Controlled Voltage Source (E)10R1 = Voltage Gain (AV)
Current-Controlled Voltage Source (H)11R1 = Transresistance (RT)


Note:  For all above Circuit options, the GOFFST and ID real constants (numbers 15 and 16) are created by the Circuit Builder automatically:


Figure 124.3: Load Functions and Corresponding Real Constants for Independent Current and Voltage Sources

Load Functions and Corresponding Real Constants for Independent Current and Voltage Sources
Load Functions and Corresponding Real Constants for Independent Current and Voltage Sources
Load Functions and Corresponding Real Constants for Independent Current and Voltage Sources
Load Functions and Corresponding Real Constants for Independent Current and Voltage Sources

CIRCU124 Output Data

The element output for this element is dependent on the circuit option selected. Table 124.2: CIRCU124 Element Output Definitions summarizes the element output data.

The Element Output Definitions table uses the following notation:

A colon (:) in the Name column indicates that the item can be accessed by the Component Name method (ETABLE, ESOL). The O column indicates the availability of the items in the file jobname.out. The R column indicates the availability of the items in the results file.

In either the O or R columns, “Y” indicates that the item is always available, a letter or number refers to a table footnote that describes when the item is conditionally available, and “-” indicates that the item is not available.

Table 124.2: CIRCU124 Element Output Definitions

NameDefinitionOR
For KEYOPT(1) = 0: Resistor
ELElement NumberYY
NODESNodes - I, JYY
RESResistanceYY
VOLTAGEVoltage drop between node I and node JYY
CURRENTCurrentYY
POWERPower lossYY
For KEYOPT(1) = 1: Inductor
ELElement NumberYY
NODESNodes - I, JYY
INDInductanceYY
IL0Initial currentYY
VOLTAGEVoltage drop between node I and node JYY
CURRENTCurrentYY
POWERPower absorptionYY
For KEYOPT(1) = 2: Capacitor
ELElement NumberYY
NODESNodes - I, JYY
CAPCapacitanceYY
VC0Initial voltageYY
VOLTAGEVoltage drop between node I and node JYY
CURRENTCurrentYY
POWERPower absorptionYY
For KEYOPT(1) = 3: Independent Current Source
ELElement NumberYY
NODESNodes - I, JYY
CURRENT SOURCEReal or imaginary component of applied currentYY
VOLTAGEVoltage drop between node I and node JYY
CURRENTCurrentYY
POWERPower (loss if positive, output if negative)YY
For KEYOPT(1) = 4: Independent Voltage Source
ELElement NumberYY
NODESNodes - I, J, KYY
VOLTAGE SOURCEReal or imaginary component of applied voltageYY
VOLTAGEVoltage drop between node I and node JYY
CURRENTCurrent at node KYY
POWERPower (loss if positive, output if negative)YY
For KEYOPT(1) = 8: 3D Mutual Inductor (Transformer)
ELElement NumberYY
NODESNodes - I, J, K, LYY
IND1Primary inductanceYY
IND2Secondary inductanceYY
INDMMutual inductanceYY
VOLTAGEVoltage drop between node I and node JYY
CURRENTCurrent in I-J branchYY
CONTROL VOLTVoltage drop between node K and node LYY
CONTROL CURRCurrent in K-L branchYY
POWERPower absorptionYY
For KEYOPT(1) = 9: Voltage Controlled Current Source
ELElement NumberYY
NODESNodes - I, J, K, LYY
GTTransconductanceYY
VOLTAGEVoltage drop between node I and node JYY
CURRENTCurrent in I-J branchYY
CONTROL VOLTVoltage drop between node K and node LYY
POWERPower (loss if positive, output if negative)YY
For KEYOPT(1) = 10: Voltage Controlled Voltage Source
ELElement NumberYY
NODESNodes - I, J, K, L, MYY
AVVoltage gainYY
VOLTAGEVoltage drop between node I and node JYY
CURRENTCurrent at node KYY
CONTROL VOLTVoltage drop between node L and node MYY
POWERPower (loss if positive, output if negative)YY
For KEYOPT(1) = 11: Current Controlled Voltage Source
ELElement NumberYY
NODESNodes - I, J, K, L, M, NYY
GTTransresistance YY
VOLTAGEVoltage drop between node I and node JYY
CURRENTCurrent at node KYY
CONTROL VOLTVoltage drop between node L and node MYY
CONTROL CURRCurrent at node NYY
POWERPower (loss if positive, output if negative)YY
For KEYOPT(1) = 12: Current Controlled Current Source
ELElement NumberYY
NODESNodes - I, J, K, L, M, NYY
AICurrent gainYY
VOLTAGEVoltage drop between node I and node JYY
CURRENTCurrent at node KYY
CONTROL VOLTVoltage drop between node L and node MYY
CONTROL CURRCurrent at node NYY
POWERPower (loss if positive, output if negative)YY

Table 124.3: CIRCU124 Item and Sequence Numbers lists output available through the ETABLE command using the Sequence Number method. See The General Postprocessor (POST1) in the Basic Analysis Guide and The Item and Sequence Number Table in this reference for more information. The following notation is used in Table 124.3: CIRCU124 Item and Sequence Numbers:

Name

output quantity as defined in the Table 124.2: CIRCU124 Element Output Definitions

Item

predetermined Item label for ETABLE command

E

sequence number for single-valued or constant element data

Table 124.3: CIRCU124 Item and Sequence Numbers

Output Quantity NameETABLE and ESOL Command Input
ItemE
VOLTAGESMISC1
CURRENTSMISC2
CONTROL VOLTSMISC3
CONTROL CURRSMISC4
POWERNMISC1
SOURCE (real)NMISC2
SOURCE (imaginary)NMISC3

CIRCU124 Assumptions and Restrictions

  • For static analyses, a capacitor circuit element is treated as an open-circuit and an inductor circuit element is treated as a short-circuit.

  • Only MKS units are allowed (EMUNIT command).

  • The resistor, inductor, capacitor, independent current source, and mutual inductor circuit options produce symmetric coefficient matrices while the remaining options produce unsymmetric matrices.

  • The sparse solver is the default for problems using the CIRCU124 element. Even if you choose a different solver, Mechanical APDL switches to the sparse solver when CIRCU124 elements are present.

  • This element may not be compatible with other elements with the VOLT degree of freedom. To be compatible, the elements must have the same reaction force (see Element Compatibility in the Low-Frequency Electromagnetic Analysis Guide).

CIRCU124 Product Restrictions

There are no product-specific restrictions for this element.