Engine

Simple torque driver Engine component

The Engine component provides a first-approximation model for any type of internal combustion engine (spark ignition, diesel, etc.). The engine power characteristics are determined by a lookup table for power vs. engine speed data, or torque vs. engine speed data.

Equations

Where ${\mathrm{ϕ}}_{b}$  is the absolute rotation angle ${\mathrm{flange}}_{b}$ and the engine output torque is defined by:

Where

is the throttle input



Also

and

Where ${\mathrm{\omega }}_{\mathrm{min}}$ and ${\mathrm{\omega }}_{\mathrm{max}}$ are the lower and upper speed limits where the engine exerts torque, respectively.

Also   is a constant to adjust how quickly output torque goes to zero once the engine speed falls outside the set limits.
${k}_{\mathrm{\omega }}$, ${k}_{p}$, and ${k}_{T}$  are the speed, power, and torque unit conversion factors, respectively.

${\mathrm{\chi }}_{\mathit{in}}$ is the interpolation function that uses user input data and depending on the choice for the mode parameter, the input data is either torque vs. speed data or power vs. speed data

Connections

 Name Condition Description ID ${\mathrm{flange}}_{b}$ - Engine output shaft flange_b - Real input port for engine throttle, from 0 (idle) to 1 (maximum torque) throttle $\mathrm{support}$ loss

Parameters

Symbol

Condition

Default

Units

Description

ID

$\mathrm{mode}$

-

torque vs. speed

-

Defines whether:

 • Torque vs. speed data is used to calculate engine torque [torque vs. speed] or
 • Power vs. speed data is used to calculate engine torque [power vs. speed]

enginedatamode

${\mathrm{\omega }}_{\mathrm{min}}$

-

$\frac{\mathrm{rad}}{s}$

Stall speed of the engine

minw

${\mathrm{\omega }}_{\mathrm{max}}$

-

$\frac{\mathrm{rad}}{s}$

Maximum speed of the engine

maxw

${k}_{0}$

-

$0.1$

$\frac{s}{\mathrm{rad}}$

Factor controlling the rate at which engine torque goes to zero outside the operating range.

k0

data source

-

GUI

-

Defines the source for the loss data:

 • entered via GUI [GUI]
 • by an attachment [attachment]
 • by an external file [file]

datasourcemode

-

false

-

Enables/disables the support flange

useSupport



RPM

-

Defines whether the speed data has the unit:

 • RPM [RPM]
 • User defined [user-defined]

angularspeedunitmode

${k}_{\mathrm{ω}}$

speed unit = user defined

$1$

$\frac{\mathrm{rad}}{\frac{s}{\left[{U}_{\mathrm{user}}\right]}}$

Speed conversion factor from the user-defined unit [${U}_{\mathrm{user}}$] to rad/s

userspeedscale

mode = torque vs. speed

$\mathbf{N}\mathbf{·}\mathbf{m}$

-

Defines whether the torque data has the unit:

 • lb-ft [pound-feet]
 • User defined [user-defined]

torqueunitmode

${k}_{t}$

torque unit = user-defined

$1$

$\frac{N·m}{\left[{U}_{\mathrm{user}}\right]}$

Torque conversion factor from the user-defined unit [${U}_{\mathrm{user}}$] to N.m

usertorquescale

mode = power vs. speed

kW

-

Defines whether the torque data has the unit:

 • Watt [W]
 • Kilo Watt [kW]
 • horsepower [hp]
 • User defined [user-defined]

powerunitmode

${k}_{p}$

power unit = user-defined

$1$

$\frac{W}{\left[{U}_{\mathrm{user}}\right]}$

Torque conversion factor from the user-defined unit [${U}_{\mathrm{user}}$] to N.m

userpowerscale

data

data source = GUI

-

Defines engine curve:

 • if mode = [torque vs. speed]:  the data is interpreted as speed-dependent maximum torque. (1st column speed, 2nd column torque)
 • if mode = [power vs. speed]:the data is interpreted as speed-dependent maximum power. (1st column speed, 2nd column power)

engineData

data source = attachment

$-$



Defines engine curve:

 • if mode = [torque vs. speed]: the data is interpreted as speed-dependent maximum torque. (1st column speed, column number given by column parameter is torque)
 • if mode = [power vs. speed]: the data is interpreted as speed-dependent maximum power. (1st column speed, column number given by column parameter is power)

data

data source = file

$-$



fileName

$\mathrm{column}$

data source = attachment or file

2

-

The column number where the engine data is stored

1st column is always the speed data

column

smoothness

-

Table points are linearly interpolated

-

Defines the smoothness of table interpolation

There are two options:

 • Table points are linearly interpolated
 • Table points are interpolated such that the first derivative is continuous

smoothness