Skip to main content

Motion Standalone Preprocessor C# library 2025 R1

Class CarForceAPI

Last update: 16.07.2025

Namespace: VM.API.Pre.Car
Assembly: VM.API.Pre.Car.dll

This class implements APIs for car force.

public static class CarForceAPI

Inheritance

objectCarForceAPI

Extension Methods

LinkPropertyItemCache.GetLinkProperties(object, LinkPropertyType), LinkPropertyItemCache.GetLinkPropertiesAndValues(object, LinkPropertyType), LinkPropertyItemCache.GetLinkedObjects(object, LinkPropertyType)

Methods

CreateBumpStop(IPostTemplateBasedDocument, string, Obj, Obj, Vector, Vector, string, SymmetricType)

Create

[NotNull(new string[] { "document" })]
[NotNullObj(new string[] { "baseEntity", "actionEntity" })]
[MatchTypeObj(new object[] { "baseEntity", typeof(IConnectable), "actionEntity", typeof(IConnectable) })]
[ExistFile(new string[] { "propertyFilePath" })]
public static Obj CreateBumpStop(this IPostTemplateBasedDocument document, string propertyFilePath, Obj baseEntity, Obj actionEntity, Vector basePosition, Vector actionPosition, string name = "", SymmetricType symmetricType = SymmetricType.Left)

Parameters

document IPostTemplateBasedDocument

The to create a bump stop.

propertyFilePath string

The bump stop property file path.

baseEntity Obj

The base entity of a bump stop.

actionEntity Obj

The action entity of a bump stop.

basePosition Vector

The base position of a bump stop.

actionPosition Vector

The action position of a bump stop.

name string

The name of a bump stop.

symmetricType SymmetricType

The symmetric type of the new .

Returns

Obj

the new object created by this API.

Exceptions

ArgumentNullException

Will be thrown if 'document', 'baseEntity', 'actionEntity' argument is null.

ArgumentException

Will be thrown if the type of 'baseEntity', 'actionEntity' is not .

ArgumentException

Will be thrown if extension of 'propertyFilePath' is not .cpfbsxml.

FileNotFoundException

Will be thrown if 'propertyFilePath' does not exist.

CreateBush(IPostTemplateBasedDocument, string, Obj, Obj, Vector, OMatrix?, string, SymmetricType)

Create

[NotNull(new string[] { "document" })]
[NotNullObj(new string[] { "baseEntity", "actionEntity" })]
[MatchTypeObj(new object[] { "baseEntity", typeof(IConnectable), "actionEntity", typeof(IConnectable) })]
[ExistFile(new string[] { "propertyFilePath" })]
public static Obj CreateBush(this IPostTemplateBasedDocument document, string propertyFilePath, Obj baseEntity, Obj actionEntity, Vector basePosition, OMatrix? orientation = null, string name = "", SymmetricType symmetricType = SymmetricType.Left)

Parameters

document IPostTemplateBasedDocument

The to create a bush.

propertyFilePath string

The bush property file path.

baseEntity Obj

The base entity of a bush.

actionEntity Obj

The action entity of a bush.

basePosition Vector

The base position of a bush.

orientation OMatrix?

The orientation of a bush force. The default value is identity.

name string

The name of a bush.

symmetricType SymmetricType

The symmetric type of the new .

Returns

Obj

the new object created by this API.

Exceptions

ArgumentNullException

Will be thrown if 'document', 'baseEntity', 'actionEntity' argument is null.

ArgumentException

Will be thrown if the type of 'baseEntity', 'actionEntity' is not .

ArgumentException

Will be thrown if extension of 'propertyFilePath' is not .dfpfbxml.

ArgumentException

Will be thrown if the magnitude of 'orientation' is 0.

FileNotFoundException

Will be thrown if 'propertyFilePath' does not exist.

CreateDamper(IPostTemplateBasedDocument, string, Obj, Obj, Vector, Vector, string, SymmetricType)

Create

[NotNull(new string[] { "document" })]
[NotNullObj(new string[] { "baseEntity", "actionEntity" })]
[MatchTypeObj(new object[] { "baseEntity", typeof(IConnectable), "actionEntity", typeof(IConnectable) })]
[ExistFile(new string[] { "propertyFilePath" })]
public static Obj CreateDamper(this IPostTemplateBasedDocument document, string propertyFilePath, Obj baseEntity, Obj actionEntity, Vector basePosition, Vector actionPosition, string name = "", SymmetricType symmetricType = SymmetricType.Left)

Parameters

document IPostTemplateBasedDocument

The to create a damper.

propertyFilePath string

The damper property file path.

baseEntity Obj

The base entity of a damper.

actionEntity Obj

The action entity of a damper.

basePosition Vector

The base position of a damper.

actionPosition Vector

The action position of a damper.

name string

The name of a damper.

symmetricType SymmetricType

The symmetric type of the new .

Returns

Obj

the new object created by this API.

Exceptions

ArgumentNullException

Will be thrown if 'document', 'baseEntity', 'actionEntity' argument is null.

ArgumentException

Will be thrown if the type of 'baseEntity', 'actionEntity' is not .

ArgumentException

Will be thrown if extension of 'propertyFilePath' is not .cpfdxml.

FileNotFoundException

Will be thrown if 'propertyFilePath' does not exist.

CreateReboundStop(IPostTemplateBasedDocument, string, Obj, Obj, Vector, Vector, string, SymmetricType)

Create

[NotNull(new string[] { "document" })]
[NotNullObj(new string[] { "baseEntity", "actionEntity" })]
[MatchTypeObj(new object[] { "baseEntity", typeof(IConnectable), "actionEntity", typeof(IConnectable) })]
[ExistFile(new string[] { "propertyFilePath" })]
public static Obj CreateReboundStop(this IPostTemplateBasedDocument document, string propertyFilePath, Obj baseEntity, Obj actionEntity, Vector basePosition, Vector actionPosition, string name = "", SymmetricType symmetricType = SymmetricType.Left)

Parameters

document IPostTemplateBasedDocument

The to create a rebound stop.

propertyFilePath string

The rebound stop property file path.

baseEntity Obj

The base entity of a rebound stop.

actionEntity Obj

The action entity of a rebound stop.

basePosition Vector

The base position of a rebound stop.

actionPosition Vector

The action position of a rebound stop.

name string

The name of a rebound stop.

symmetricType SymmetricType

The symmetric type of the new .

Returns

Obj

the new object created by this API.

Exceptions

ArgumentNullException

Will be thrown if 'document', 'baseEntity', 'actionEntity' argument is null.

ArgumentException

Will be thrown if the type of 'baseEntity', 'actionEntity' is not .

ArgumentException

Will be thrown if extension of 'propertyFilePath' is not .cpfrbsxml.

FileNotFoundException

Will be thrown if 'propertyFilePath' does not exist.

CreateSpring(IPostTemplateBasedDocument, string, Obj, Obj, Vector, Vector, string, SymmetricType)

Create

[NotNull(new string[] { "document" })]
[NotNullObj(new string[] { "baseEntity", "actionEntity" })]
[MatchTypeObj(new object[] { "baseEntity", typeof(IConnectable), "actionEntity", typeof(IConnectable) })]
[ExistFile(new string[] { "propertyFilePath" })]
public static Obj CreateSpring(this IPostTemplateBasedDocument document, string propertyFilePath, Obj baseEntity, Obj actionEntity, Vector basePosition, Vector actionPosition, string name = "", SymmetricType symmetricType = SymmetricType.Left)

Parameters

document IPostTemplateBasedDocument

The to create a spring.

propertyFilePath string

The spring property file path.

baseEntity Obj

The base entity of a spring.

actionEntity Obj

The action entity of a spring.

basePosition Vector

The base position of a spring.

actionPosition Vector

The action position of a spring.

name string

The name of a spring.

symmetricType SymmetricType

The symmetric type of the new .

Returns

Obj

the new object created by this API.

Exceptions

ArgumentNullException

Will be thrown if 'document', 'baseEntity', 'actionEntity' argument is null.

ArgumentException

Will be thrown if the type of 'baseEntity', 'actionEntity' is not .

ArgumentException

Will be thrown if extension of 'propertyFilePath' is not .cpfsxml.

FileNotFoundException

Will be thrown if 'propertyFilePath' does not exist.

CreateTire(SubSystemDocument, string, TMatrix, SideType, string, ExpressionValueVariable?, ExpressionValueVariable?, ExpressionValueVariable?, ExpressionValueVariable?, ExpressionValueVariable?, Color?, SymmetricType, bool)

Create

[NotNull(new string[] { "subSystemDocument" })]
[ExistFile(new string[] { "tirePropertyFile" })]
public static Obj CreateTire(this SubSystemDocument subSystemDocument, string tirePropertyFile, TMatrix transform, WheelBodyBase.SideType side = SideType.Left, string name = "", ExpressionValueVariable? cmOffset = null, ExpressionValueVariable? mass = null, ExpressionValueVariable? lxxlyy = null, ExpressionValueVariable? lzz = null, ExpressionValueVariable? wheelCenterOffset = null, Color? color = null, SymmetricType symmetricType = SymmetricType.Left, bool isInterface = false)

Parameters

subSystemDocument SubSystemDocument

The to create a tire force.

tirePropertyFile string

The tire property file of a tire force.

transform TMatrix

The transform of a tire force.

side WheelBodyBase.SideType

The side of a tire force.

name string

The name of a leaf spring.

cmOffset ExpressionValueVariable?

The CM Offset of a tire force.

mass ExpressionValueVariable?

The mass of a tire force.

lxxlyy ExpressionValueVariable?

The lxxlyy of a tire force.

lzz ExpressionValueVariable?

The lzz of a tire force.

wheelCenterOffset ExpressionValueVariable?

The wheel center offset of a tire force.

color Color?

The color of a tire force.

symmetricType SymmetricType

The symmetric type of the new Tire.

isInterface bool

'true' if it is interface body. Otherwise, 'false'.

Returns

Obj

the new Tire object created by this API.

Exceptions

ArgumentNullException

Will be thrown if 'subSystemDocument' argument is null.

FileNotFoundException

Will be thrown if 'tirePropertyFile' file does not exist.

Connect with Ansys