# CableBundleCrossSection

A cable bundle cross section.

## Example

app = cf.GetApplication()
project = app:OpenFile(FEKO_HOME..[[/shared/Resources/Automation/Cables.cfx]])

-- Add a cable bundle cross section

bundledCables =
{
project.Cables.CrossSections["SingleConductor1"],
project.Cables.CrossSections["TwistedPair1"]
}

-- Apply a sheath around the bundle

properties = bundle:GetProperties()
properties.ShieldType = cf.Enums.CableBundleShieldTypeEnum.SheathInBackgroundMedium
properties.InsulationMedium = project.Media["Insulation"]
bundle:SetProperties(properties)


## Inheritance

The CableBundleCrossSection object is derived from the CableCrossSection object.

## Property List

AutoBundleEnabled
True if the cables must be auto-bundled. (Read/Write boolean)
True if the outer radius must be automatically calculated. It is available except when 'ShieldType' is 'InBackgroundMedium' . (Read/Write boolean)
CablePerUnitLengthAccuracy
Select a higher accuracy when calculating cable per-unit-length parameters. (Read/Write CablePerUnitLengthAccuracyEnum)
Coated
True if the shield is coated. (Read/Write boolean)
CoatingMedium
The shield coating medium. Only applies if the Coated property is true. (Read/Write Medium)
CoatingThickness
The coating thickness. Only applies if the Coated property is true. (Read/Write Expression)
InsulationMedium
The internal insulation medium. It is available except when 'ShieldType' is 'InBackgroundMedium'. (Read/Write Medium)
Label
The bundle outer radius. It is available except when 'ShieldType' is 'InBackgroundMedium'. (Read/Write Expression)
SheathThickness
The sheath thickness. It is only available when 'ShieldType' is 'SheathInBackgroundMedium' . (Read/Write Expression)
Shield
The shield type around the bundle. It is only available when 'ShieldType' is 'InDielectricWithShield'. (Read/Write CableShieldEntity)
ShieldType
TwistDirection
The cable bundle twist direction. (Read/Write CableBundleTwistDirectionEnum)
TwistPitchLength
The cable bundle twist pitch length. It is not available when 'TwistDirection' is 'NoTwist'. (Read/Write Expression)
Type
The object type string. (Read only string)

## Collection List

BundledCables
The internal cables contained in the bundle. (CableBundleCableSpecificationCollection of CableBundleCableSpecification.)

## Method List

Delete ()
Deletes the cable cross section.
Duplicate ()
Duplicate the cable cross section. (Returns a CableCrossSection object.)
GetProperties ()
Returns a table of properties representing the state of the object. The properties table can be used with the SetProperties method to change multiple properties of the object in one step. (Returns a table object.)
Rearrange ()
Rearranges the cables in the bundle.
Rearrange (seed number)
Rearranges the cables in the bundle using the given seed.
SetProperties (properties table)
Modifies the state of the object using the provided table of properties. This method is used to modify multiple properties of the object in a single step.

## Static Function List

GetDefaultProperties ()
Creates a table containing the default settings to create an object. (Returns a table object.)

## Property Details

AutoBundleEnabled
True if the cables must be auto-bundled.
Type
boolean
Access
True if the outer radius must be automatically calculated. It is available except when 'ShieldType' is 'InBackgroundMedium' .
Type
boolean
Access
CablePerUnitLengthAccuracy
Select a higher accuracy when calculating cable per-unit-length parameters.
Type
CablePerUnitLengthAccuracyEnum
Access
Coated
True if the shield is coated.
Type
boolean
Access
CoatingMedium
The shield coating medium. Only applies if the Coated property is true.
Type
Medium
Access
CoatingThickness
The coating thickness. Only applies if the Coated property is true.
Type
Expression
Access
InsulationMedium
The internal insulation medium. It is available except when 'ShieldType' is 'InBackgroundMedium'.
Type
Medium
Access
Label
The object label.
Type
string
Access
Type
number
Access
The bundle outer radius. It is available except when 'ShieldType' is 'InBackgroundMedium'.
Type
Expression
Access
SheathThickness
The sheath thickness. It is only available when 'ShieldType' is 'SheathInBackgroundMedium' .
Type
Expression
Access
Shield
The shield type around the bundle. It is only available when 'ShieldType' is 'InDielectricWithShield'.
Type
CableShieldEntity
Access
ShieldType
The shield type.
Type
CableBundleShieldTypeEnum
Access
TwistDirection
The cable bundle twist direction.
Type
CableBundleTwistDirectionEnum
Access
TwistPitchLength
The cable bundle twist pitch length. It is not available when 'TwistDirection' is 'NoTwist'.
Type
Expression
Access
Type
The object type string.
Type
string
Access

## Collection Details

BundledCables
The internal cables contained in the bundle.
Type
CableBundleCableSpecificationCollection

## Method Details

Delete ()
Deletes the cable cross section.
Duplicate ()
Duplicate the cable cross section.
Return
CableCrossSection
The duplicated entity.
GetProperties ()
Returns a table of properties representing the state of the object. The properties table can be used with the SetProperties method to change multiple properties of the object in one step.
Return
table
A properties table.
Rearrange ()
Rearranges the cables in the bundle.
Rearrange (seed number)
Rearranges the cables in the bundle using the given seed.
Input Parameters
seed(number)
The seed to use to perform the random rearrange.
SetProperties (properties table)
Modifies the state of the object using the provided table of properties. This method is used to modify multiple properties of the object in a single step.
Input Parameters
properties(table)
A table of properties defining the new state of the object.

## Static Function Details

GetDefaultProperties ()
Creates a table containing the default settings to create an object.
Return
table
The default properties table.