17.6 Surface-Inlet Current Source#

Defines current-inlet faces on the end faces of conductor regions in the finite-element mesh, allowing both externally supplied current and eddy current to be considered in eddy-current analysis.

Settings#

SUFCUR(17.6) JSON key: surface-inlet current source object

SERIES_ID(17.6) Series ID.

IN_ROTOR(17.6) Flag indicating whether the defined region is in the rotor.

SMAT_ID(17.6) Material ID of the surface elements forming the inlet face.

CURRENT(17.6) Normalized current value.

SUFCUR2(17.6.2) JSON key: multi-conductor surface-inlet current source object

SERIES_ID(17.6.2) Series ID.

IN_ROTOR(17.6.2) Flag indicating whether the defined region is in the rotor.

MAT_IDS(17.6.2) Material IDs of the elements.

SMAT_ID(17.6.2) Material ID of the surface elements forming the inlet face.

CURRENT(17.6.2) Normalized current value.

Input format#

Text-format section
Type:

Fixed parameter set 1

Number of lines:

1

Number of parameters:

6

Text format#
* SUFCUR * SERIES_NO * TIME_ID * SURFACE_MAT_ID * CURRENT * IN_ROTOR *
SUFCUR        I         I         I                 E       I
Text-format section
Type:

Fixed parameter set 1

Number of lines:

2

Number of parameters:

4, 3

Text format#
* SUFCUR2 * SERIES_NO * NO_PARTS * IN_ROTOR *
SUFCUR2        I         I        I
* MAT_ID * SMAT_ID * CURENT *
    I      I        E

JSON format#

JSON format from 2024.11#
"17_Field_Source" :
[
    {
        "SUFCUR" :
        {
            "SERIES_ID" : I,
            "TIME_ID" : I,
            "SMAT_ID" : I,
            "CURRENT" : E,
            "IN_ROTOR" : I
                    },
        "SUFCUR2" :
        {
            "SERIES_ID" : I,
            "IN_ROTOR" : I,
            "data" :
            [
                {
                    "MAT_IDS" : [ I ],
                    "SMAT_ID" : I,
                    "CURRENT" : E,
                    "CAL_Je" : I
                }
            ]
        }
    }
]

Detailed description#

SUFCUR defines a current-inlet face on the end face of a conductor region, allowing both externally supplied current and eddy current to be considered in eddy-current analysis.

Hint

In two-dimensional analysis, using SUFCUR is equivalent to assigning current to a conductor that includes eddy current.

In three-dimensional analysis, the current distribution is the superposition of conduction current following the conductor geometry and eddy current caused by effects such as the skin effect.

Use SUFCUR2 when current is assigned to multiple conductor regions. For example, it can be used to connect a motor coil consisting of multiple conductors to a power source and calculate the linked flux.

SUFCUR#

SUFCUR(17.6)#
Text-format section
Fixed parameter set 1#
[row, col] = [1, 1]
Type:

String (S)

Description:

Specifies the surface-inlet current source SUFCUR.

SERIES_ID#

SERIES_ID(17.6)#
Text-format section
Fixed parameter set 1#
[row, col] = [1, 2]
Type:

Integer (I)

Description:

Source-term identifier.

TIME_ID(17.6)#
Text-format section
Fixed parameter set 1#
[row, col] = [1, 3]
Type:

Integer (I)

Description:

Time-definition ID used when a time-dependent current is specified.

Hint

Set this to 0 when the source is connected to CIRCUIT(17.8) or NETWORK(17.9). Connection to CIRCUIT(17.8) or NETWORK(17.9) is recommended.

SMAT_ID#

SMAT_ID(17.6)#
Text-format section
Fixed parameter set 1#
[row, col] = [2, 1]
Type:

Integer (I)

Description:

Material ID of the surface elements forming the inlet face. The face orientation is arbitrary.

CURRENT#

CURRENT(17.6)#
Text-format section
Fixed parameter set 1#
[row, col] = [2, 2]
Type:

Real (E)

Unit:

A

Description:

Normalized current passing through the face.

IN_ROTOR#

IN_ROTOR(17.6)#
Text-format section
Fixed parameter set 1#
[row, col] = [1, 4]
Flag indicating whether the defined region is in the rotor#

Value

Description

0

In the fixed part. Default value

1

In the moving part.

Required for steady AC analysis with slip caused by sliding motion when N_CORRECT(8) ≠ 0.

SUFCUR definition example

Example definition of SUFCUR#


SUFCUR2#

SUFCUR2(17.6.2)#
Text-format section
Fixed parameter set 1#
[row, col] = [1, 1]
Type:

String (S)

Description:

Specifies the multi-conductor surface-inlet current source SUFCUR2.

The setup procedure is almost the same as for PHICOIL(17.4).

During calculation, it is treated as SUFCUR. When the linked flux of conductor regions is calculated during post-processing for an electrical-circuit connection, the normalized DC current distribution calculated as PHICOIL(17.4) is used. Therefore, it is equivalent to a field source based on PHICOIL(17.4) that considers eddy currents.

Hint

Use SUFCUR2 when current is assigned to multiple conductor regions. For example, it can be used to connect a motor coil consisting of multiple conductors to a power source and calculate the linked flux.

Like SUFCUR, SUFCUR2 defines a current-inlet face on the end face of a conductor region and allows both externally supplied current and eddy current to be considered in eddy-current analysis.

SERIES_ID#

SERIES_ID(17.6.2)#
Text-format section
Fixed parameter set 1#
[row, col] = [1, 2]
Type:

Integer (I)

Description:

Source-term identifier.

Text-format section

NO_PARTS (text format only)

Fixed parameter set 1#
[row, col] = [1, 3]
Type=I

Number of properties assigned to the region. Each SUFCUR2 specified by NO_PARTS must have an independent conductor region and current-inlet face.

IN_ROTOR#

IN_ROTOR(17.6.2)#
Text-format section
Fixed parameter set 1#
[row, col] = [1, 4]
Flag indicating whether the defined region is in the rotor#

Value

Description

0

In the fixed part. Default value

1

In the moving part.

Required for steady AC analysis with slip caused by sliding motion when N_CORRECT(8) ≠ 0.

data#

data(17.4)#
JSON key:

Surface-inlet current source data

data is an array with one entry for each SUFCUR2 element.

MAT_IDS#
MAT_IDS(17.6.2)#
Text-format section
Fixed parameter set 1#
[row, col] = [2, 1]
Type:

Integer array (I)

Description:

Material IDs of the elements ( MAT_ID(16.1) ).

Note

When multiple conductor regions are defined as one SUFCUR2, use JSON format and specify the material IDs as an array.

SMAT_ID#
SMAT_ID(17.6.2)#
Text-format section
Fixed parameter set 1#
[row, col] = [2, 2]
Type:

Real (E)

Unit:

A

Description:

Normalized current passing through the face.

CURRENT#
CURRENT(17.6.2)#
Text-format section
Fixed parameter set 1#
[row, col] = [2, 3]
Type:

Real (E)

Unit:

A

Description:

Normalized current passing through the face.

For a wound coil, it may be easier to understand this value as the number of turns.