Mapped SI Engine

Spark-ignition engine model using lookup tables

Library:
Powertrain Blockset / Propulsion / Combustion Engines
Vehicle Dynamics Blockset / Powertrain / Propulsion

Description

The Mapped SI Engine block implements a mapped spark-ignition (SI) engine model using power, air mass flow, fuel flow, exhaust temperature, efficiency, and emission performance lookup tables. You can use the block for:

Hardware-in-the-loop (HIL) engine control design
Vehicle-level fuel economy and performance simulations

The block enables you to specify lookup tables for these engine characteristics. The lookup tables, developed with the Model-Based Calibration Toolbox™, are functions of commanded torque, T_cmd, brake torque, T_brake, and engine speed, N. If you select Input engine temperature, the tables are also a function of engine temperature, Temp_Eng.

Table	Input Engine Temperature Parameter Setting
Table	`off`	`on`
Power	ƒ(T_cmd,N)	ƒ(T_cmd,N,Temp_Eng)
Air	ƒ(T_brake,N)	ƒ(T_brake,N,Temp_Eng)
Fuel
Temperature
Efficiency
HC
CO
NOx
CO2
PM

To bound the Mapped SI Engine block output, the block does not extrapolate the lookup table data.

Virtual Calibration

If you have Model-Based Calibration Toolbox, click Calibrate Maps to virtually calibrate the 2D lookup tables using measured data. The dialog box steps through these tasks.

Task

Description

Import firing data

Import this loss data from a file. For example, open <matlabroot>/toolbox/autoblks/autodemos/projectsrc/SIDynamometer/CalMappedEng/SiEngineData.xlsx.

For more information, see Using Data (Model-Based Calibration Toolbox).

Required Data	Optional Data
Engine speed, rpm Engine torque, N·m	Air mass flow rate, kg/s Brake specific fuel consumption, g/(kW·h) CO2 mass flow rate, kg/s CO mass flow rate, kg/s Exhaust temperature, K Fuel mass flow rate, kg/s HC mass flow rate, kg/s NOx mass flow rate, kg/s Particulate matter mass flow rate, kg/s

Collect firing data at steady-state operating conditions when injectors deliver the fuel. Data should cover the engine speed and torque operating range. Model-Based Calibration Toolbox uses the firing data boundary as the maximum torque.

To filter or edit the data, select Edit in Application. The Model-Based Calibration Toolbox Data Editor opens.

Import non-firing data

Import this non-firing data from a file. For example, open <matlabroot>/toolbox/autoblks/autodemos/projectsrc/SIDynamometer/CalMappedEng/SiEngineData.xlsx.

Engine speed, rpm
Engine torque, N·m

Collect non-firing (motoring) data at steady-state operating conditions when fuel is cut off. All non-firing torque points must be less than zero. Non-firing data is a function of engine speed only.

Generate response models

For both firing and non-firing data, the Model-Based Calibration Toolbox uses test plans to fit data to Gaussian process models (GPMs).

To assess or adjust the response model fit, select Edit in Application. The Model-Based Calibration Toolbox Model Browser opens. For more information, see Model Assessment (Model-Based Calibration Toolbox).

Generate calibration

Model-Based Calibration Toolbox calibrates the firing and non-firing response models and generates calibrated tables.

To assess or adjust the calibration, select Edit in Application. The Model-Based Calibration Toolbox CAGE Browser opens. For more information, see Calibration Lookup Tables (Model-Based Calibration Toolbox).

Update block parameters

Update the block lookup table and breakpoint parameters with the calibration.

Cylinder Air Mass

The block calculates the normalized cylinder air mass using these equations.

$\begin{array}{l} M_{N o m} = \frac{P_{s t d} V_{d}}{N_{c y l} R_{a i r} T_{s t d}} \\ L = \frac{(\frac{60 s}{m i n}) C p s \cdot {\dot{m}}_{a i r}}{(\frac{1000 g}{K g}) N_{c y l} \cdot N \cdot M_{N o m}} \end{array}$

The equations use these variables.

L	Normalized cylinder air mass
$M_{N o m}$	Nominal engine cylinder air mass at standard temperature and pressure, piston at bottom dead center (BDC) maximum volume, in kg
$C p s$	Crankshaft revolutions per power stroke, rev/stroke
$P_{s t d}$	Standard pressure
$T_{s t d}$	Standard temperature
$R_{a i r}$	Ideal gas constant for air and burned gas mixture
$V_{d}$	Displaced volume
$N_{c y l}$	Number of engine cylinders
N	Engine speed
${\dot{m}}_{i n t k}$	Engine air mass flow, in g/s

Turbocharger Lag

To model turbocharger lag, select Include turbocharger lag effect. During throttle control, the time constant models the manifold filling and emptying dynamics. When the torque request requires a turbocharger boost, the block uses a larger time constant to represent the turbocharger lag. The block uses these equations.

Dynamic torque

$\frac{d T_{b r a k e}}{d t} = \frac{1}{τ_{e n g}} (T_{s t d y} - T_{b r a k e})$

Boost time constant

$τ_{b s t} = {\begin{matrix} τ_{b s t, r i s i n g} when T_{s t d y} > T_{b r a k e} \\ τ_{b s t, f a l l i n g} when T_{s t d y} \leq T_{b r a k e} \end{matrix}$

Final time constant

$τ_{e n g} = {\begin{matrix} τ_{t h r} when T_{b r a k e} < f_{b s t} (N) \\ τ_{b s t} when T_{b r a k e} \geq f_{b s t} (N) \end{matrix}$

The equations use these variables.

T_brake	Brake torque
T_stdy	Steady-state target torque
τ_bst	Boost time constant
τ_bst,rising, τ_bst,falling	Boost rising and falling time constant, respectively
τ_eng	Final time constant
τ_thr	Time constant during throttle control
ƒ_bst(N)	Boost torque speed line
N	Engine speed

Fuel Flow

To calculate the fuel economy for high-fidelity models, the block uses the volumetric fuel flow.

$Q_{f u e l} = \frac{{\dot{m}}_{f u e l}}{(\frac{1000 k g}{m^{3}}) S g_{f u e l}}$

The equation uses these variables.

${\dot{m}}_{f u e l}$	Fuel mass flow
Sg_fuel	Specific gravity of fuel
Q_fuel	Volumetric fuel flow

Power Accounting

For the power accounting, the block implements these equations.

Bus Signal			Description	Equations
`PwrInfo`	`PwrTrnsfrd` — Power transferred between blocks Positive signals indicate flow into block Negative signals indicate flow out of block	`PwrCrkshft`	Crankshaft power	$- τ_{e n g} ω$
	`PwrNotTrnsfrd` — Power crossing the block boundary, but not transferred Positive signals indicate an input Negative signals indicate a loss	`PwrFuel`	Fuel input power	${\dot{m}}_{f u e l} L H V$
		`PwrLoss`	Power loss	$τ_{e n g} ω - {\dot{m}}_{f u e l} L H V$
	`PwrStored` — Stored energy rate of change Positive signals indicate an increase Negative signals indicate a decrease		Not used

The equations use these variables.

LHV	Fuel lower heating value
ω	Engine speed, rad/s
${\dot{m}}_{f u e l}$	Fuel mass flow
τ_eng	Fuel mass per injection time constant

Ports

Input

expand all

`TrqCmd` — Commanded torque
`scalar`

Torque, T_cmd, in N·m.

`EngSpd` — Engine speed
`scalar`

Engine speed, N, in rpm.

`EngTemp` — Engine temperature
`scalar`

Engine temperature, Temp_Eng, in K.

Dependencies

To enable this port, select Input engine temperature.

Output

expand all

`Info` — Bus signal
bus

Bus signal containing these block calculations.

Signal			Description	Units
`IntkGassMassFlw`			Engine air mass flow output	kg/s
`NrmlzdAirChrg`			Normalized engine cylinder air mass	N/A
`Afr`			Air-fuel ratio (AFR)	N/A
`FuelMassFlw`			Engine fuel flow output	kg/s
`FuelVolFlw`			Volumetric fuel flow	m³/s
`ExhManGasTemp`			Engine exhaust gas temperature	K
`EngTrq`			Engine torque output	N·m
`EngSpd`			Engine speed	rpm
`CrkAng`			Engine crankshaft absolute angle $\int_{0}^{(360) C p s} E n g S p d \frac{180}{30} d θ$ where $C p s$ is crankshaft revolutions per power stroke.	degrees crank angle
`Bsfc`			Engine brake-specific fuel consumption (BSFC)	g/kWh
`EoHC`			Engine out hydrocarbon emission mass flow	kg/s
`EoCO`			Engine out carbon monoxide emission mass flow rate	kg/s
`EoNOx`			Engine out nitric oxide and nitrogen dioxide emissions mass flow	kg/s
`EoCO2`			Engine out carbon dioxide emission mass flow	kg/s
`EoPM`			Engine out particulate matter emission mass flow	kg/s
`PwrInfo`	`PwrTrnsfrd`	`PwrCrkshft`	Crankshaft power	W
	`PwrNotTrnsfrd`	`PwrFuel`	Fuel input power	W
	`PwrNotTrnsfrd`	`PwrLoss`	Power loss	W
	`PwrStored`		Not used

`EngTrq` — Engine brake torque
`scalar`

Engine brake torque, $T_{b r a k e}$ , in N·m.

Parameters

expand all

Block Options

`Include turbocharger lag effect` — Increase time constant
`off` (default)

Dynamic torque

$\frac{d T_{b r a k e}}{d t} = \frac{1}{τ_{e n g}} (T_{s t d y} - T_{b r a k e})$

Boost time constant

$τ_{b s t} = {\begin{matrix} τ_{b s t, r i s i n g} when T_{s t d y} > T_{b r a k e} \\ τ_{b s t, f a l l i n g} when T_{s t d y} \leq T_{b r a k e} \end{matrix}$

Final time constant

$τ_{e n g} = {\begin{matrix} τ_{t h r} when T_{b r a k e} < f_{b s t} (N) \\ τ_{b s t} when T_{b r a k e} \geq f_{b s t} (N) \end{matrix}$

The equations use these variables.

T_brake	Brake torque
T_stdy	Steady-state target torque
τ_bst	Boost time constant
τ_bst,rising, τ_bst,falling	Boost rising and falling time constant, respectively
τ_eng	Final time constant
τ_thr	Time constant during throttle control
ƒ_bst(N)	Boost torque speed line
N	Engine speed

Dependencies

Selecting Include turbocharger lag effect enables these parameters:

Boost torque line, f_tbrake_bst
Time constant below boost line, tau_thr
Rising torque boost time constant, tau_bst_rising
Falling torque boost time constant, tau_bst_falling

`Input engine temperature` — Create input port
`off` (default) | `on`

Select this to create the EngTemp input port.

The block enables you to specify lookup tables for these engine characteristics. The lookup tables, developed with the Model-Based Calibration Toolbox, are functions of commanded torque, T_cmd, brake torque, T_brake, and engine speed, N. If you select Input engine temperature, the tables are also a function of engine temperature, Temp_Eng.

Table	Input Engine Temperature Parameter Setting
Table	`off`	`on`
Power	ƒ(T_cmd,N)	ƒ(T_cmd,N,Temp_Eng)
Air	ƒ(T_brake,N)	ƒ(T_brake,N,Temp_Eng)
Fuel
Temperature
Efficiency
HC
CO
NOx
CO2
PM

Configuration

`Calibrate Maps` — Calibrate tables with measured data
`selection`

If you have Model-Based Calibration Toolbox, click Calibrate Maps to virtually calibrate the 2D lookup tables using measured data. The dialog box steps through these tasks.

Task

Description

Import firing data

Import this loss data from a file. For example, open <matlabroot>/toolbox/autoblks/autodemos/projectsrc/SIDynamometer/CalMappedEng/SiEngineData.xlsx.

For more information, see Using Data (Model-Based Calibration Toolbox).

Required Data	Optional Data
Engine speed, rpm Engine torque, N·m	Air mass flow rate, kg/s Brake specific fuel consumption, g/(kW·h) CO2 mass flow rate, kg/s CO mass flow rate, kg/s Exhaust temperature, K Fuel mass flow rate, kg/s HC mass flow rate, kg/s NOx mass flow rate, kg/s Particulate matter mass flow rate, kg/s

To filter or edit the data, select Edit in Application. The Model-Based Calibration Toolbox Data Editor opens.

Import non-firing data

Import this non-firing data from a file. For example, open <matlabroot>/toolbox/autoblks/autodemos/projectsrc/SIDynamometer/CalMappedEng/SiEngineData.xlsx.

Engine speed, rpm
Engine torque, N·m

Collect non-firing (motoring) data at steady-state operating conditions when fuel is cut off. All non-firing torque points must be less than zero. Non-firing data is a function of engine speed only.

Generate response models

For both firing and non-firing data, the Model-Based Calibration Toolbox uses test plans to fit data to Gaussian process models (GPMs).

Generate calibration

Model-Based Calibration Toolbox calibrates the firing and non-firing response models and generates calibrated tables.

Update block parameters

Update the block lookup table and breakpoint parameters with the calibration.

Dependencies

To enable this parameter, clear Input engine temperature.

`Breakpoints for commanded torque, f_tbrake_t_bpt` — Breakpoints
`1`-by-`M` vector

Breakpoints, in N·m.

`Breakpoints for engine speed input, f_tbrake_n_bpt` — Breakpoints
`1`-by-`N` vector

Breakpoints, in rpm.

`Breakpoints for temperature input, f_tbrake_engtmp_bpt` — Breakpoints
`[233.15 273.15 373.15]` (default) | `1`-by-`L` vector

Breakpoints, in K.

Dependencies

To enable this parameter, select Input engine temperature.

`Number of cylinders, NCyl` — Number
`4` (default) | `scalar`

Number of cylinders.

`Crank revolutions per power stroke, Cps` — Crank revolutions
`2` (default) | `scalar`

Crank revolutions per power stroke.

`Total displaced volume, Vd` — Volume
`0.0015` (default) | `scalar`

Volume displaced by engine, in m^3.

`Fuel lower heating value, Lhv` — Heating value
`45e6` (default) | `scalar`

Fuel lower heating value, LHV, in J/kg.

`Fuel specific gravity, Sg` — Specific gravity
`0.745` (default) | `scalar`

Specific gravity of fuel, Sg_fuel, dimensionless.

`Ideal gas constant air, Rair` — Constant
`287` (default) | `scalar`

Ideal gas constant of air and residual gas entering the engine intake port, in J/(kg*K).

`Air standard pressure, Pstd` — Pressure
`101325` (default) | `scalar`

Standard air pressure, in Pa.

`Air standard temperature, Tstd` — Temperature
`293.15` (default) | `scalar`

Standard air temperature, in K.

`Boost torque line, f_tbrake_bst` — Boost lag
`1`-by-`M` vector

Boost torque line, ƒ_bst(N), in N·m.

Dependencies

To enable this parameter, select Include turbocharger lag effect.

`Time constant below boost line` — Time constant below
`0.2` (default) | `scalar`

Time constant below boost line, τ_thr, in s.

Dependencies

To enable this parameter, select Include turbocharger lag effect.

`Rising torque boost time constant, tau_bst_rising` — Rising time constant
`1.5` (default) | `scalar`

Rising torque boost time constant, τ_bst,rising, in s.

Dependencies

To enable this parameter, select Include turbocharger lag effect.

`Falling torque boost time constant, tau_bst_falling` — Falling time constant
`1` (default) | `scalar`

Falling torque boost time constant, τ_bst,falling, in s.

Dependencies

To enable this parameter, select Include turbocharger lag effect.

Power

`Brake torque map, f_tbrake` — 2D lookup table
`M`-by-`N` matrix

The engine torque lookup table is a function of commanded engine torque and engine speed, T = ƒ(T_cmd, N), where:

T is engine torque, in N·m.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.

`Plot brake torque map` — Plot table
button

Click to plot table.

Dependencies

To enable this parameter, clear Input engine temperature.

`Brake torque map, f_tbrake_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

The engine torque lookup table is a function of commanded engine torque, engine speed, and engine temperature, T = ƒ(T_cmd, N, Temp_Eng), where:

T is engine torque, in N·m.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.
Temp_Eng is engine temperature, in K.

Dependencies

To enable this parameter, select Input engine temperature.

Air

`Air mass flow map, f_air` — 2D lookup table
`M`-by-`N` matrix

The engine air mass flow lookup table is a function of commanded engine torque and engine speed, ${\dot{m}}_{i n t k}$ = ƒ(T_cmd, N), where:

${\dot{m}}_{i n t k}$ is engine air mass flow, in kg/s.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.

Dependencies

To enable this parameter, clear Input engine temperature.

`Plot air mass map` — Plot table
button

Click to plot table.

Dependencies

To enable this parameter, clear Input engine temperature.

`Air mass flow map, f_air_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

The engine air mass flow lookup table is a function of commanded engine torque, engine speed, and engine temperature, ${\dot{m}}_{i n t k}$ = ƒ(T_cmd, N, Temp_Eng), where:

${\dot{m}}_{i n t k}$ is engine air mass flow, in kg/s.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.
Temp_Eng is engine temperature, in K.

Dependencies

To enable this parameter, select Input engine temperature.

Fuel

`Fuel flow map, f_fuel` — 2D lookup table
`M`-by-`N` matrix

The engine fuel mass flow lookup table is a function of commanded engine torque and engine speed, MassFlow = ƒ(T_cmd, N), where:

MassFlow is engine fuel mass flow, in kg/s.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.

Dependencies

To enable this parameter, clear Input engine temperature.

`Plot fuel flow map` — Plot table
button

Click to plot table.

Dependencies

To enable this parameter, clear Input engine temperature.

`Fuel flow map, f_fuel_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

The engine fuel mass flow lookup table is a function of commanded engine torque, engine speed, and engine temperature, MassFlow = ƒ(T_cmd, N, Temp_Eng), where:

MassFlow is engine fuel mass flow, in kg/s.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.
Temp_Eng is engine temperature, in K.

Dependencies

To enable this parameter, select Input engine temperature.

Temperature

`Exhaust temperature map, f_texh` — 2D lookup table
`M`-by-`N` matrix

The engine exhaust temperature lookup table is a function of commanded engine torque and engine speed, T_exh = ƒ(T_cmd, N), where:

T_exh is exhaust temperature, in K.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.

Dependencies

To enable this parameter, clear Input engine temperature.

`Plot exhaust temperature map` — Plot table
button

Click to plot table.

Dependencies

To enable this parameter, clear Input engine temperature.

`Exhaust temperature map, f_texh_3d` — 3D lookup table
`array`

The engine exhaust temperature lookup table is a function of commanded engine torque, engine speed, and engine temperature, T_exh = ƒ(T_cmd, N, Temp_Eng), where:

T_exh is exhaust temperature, in K.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.
Temp_Eng is engine temperature, in K.

Dependencies

To enable this parameter, select Input engine temperature.

Efficiency

`BSFC map, f_eff` — 2D lookup table
`M`-by-`N`-by-`L` array

The brake-specific fuel consumption (BSFC) efficiency is a function of commanded engine torque and engine speed, BSFC = ƒ(T_cmd, N), where:

BSFC is BSFC, in g/kWh.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.

Dependencies

To enable this parameter, clear Input engine temperature.

`Plot BSFC map` — Plot table
button

Click to plot table.

Dependencies

To enable this parameter, clear Input engine temperature.

`BSFC map, f_eff_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

The brake-specific fuel consumption (BSFC) efficiency is a function of commanded engine torque, engine speed, and engine temperature, BSFC = ƒ(T_cmd, N, Temp_Eng), where:

BSFC is BSFC, in g/kWh.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.
Temp_Eng is engine temperature, in K.

Dependencies

To enable this parameter, select Input engine temperature.

HC

`EO HC map, f_hc` — 2D lookup table
`M`-by-`N` matrix

The engine-out hydrocarbon emissions are a function of commanded engine torque and engine speed, EO HC = ƒ(T_cmd, N), where:

EO HC is engine-out hydrocarbon emissions, in kg/s.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.

Dependencies

To enable this parameter, clear Input engine temperature.

`Plot EO HC map` — Plot table
button

Click to plot table.

Dependencies

To enable this parameter, clear Input engine temperature.

`EO HC map, f_hc_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

The engine-out hydrocarbon emissions are a function of commanded engine torque, engine speed, and engine temperature, EO HC = ƒ(T_cmd, N, Temp_Eng), where:

EO HC is engine-out hydrocarbon emissions, in kg/s.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.
Temp_Eng is engine temperature, in K.

Dependencies

To enable this parameter, select Input engine temperature.

CO

`EO CO map, f_co` — 2D lookup table
`M`-by-`N` matrix

The engine-out carbon monoxide emissions are a function of commanded engine torque and engine speed, EO CO = ƒ(T_cmd, N), where:

EO CO is engine-out carbon monoxide emissions, in kg/s.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.

Dependencies

To enable this parameter, clear Input engine temperature.

`Plot EO CO map` — Plot table
button

Click to plot table.

Dependencies

To enable this parameter, clear Input engine temperature.

`EO HC map, f_hc_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

The engine-out hydrocarbon emissions are a function of commanded engine torque, engine speed, and engine temperature, EO HC = ƒ(T_cmd, N, Temp_Eng), where:

EO HC is engine-out hydrocarbon emissions, in kg/s.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.
Temp_Eng is engine temperature, in K.

Dependencies

To enable this parameter, select Input engine temperature.

NOx

`EO NOx map, f_nox` — 2D lookup table
`M`-by-`N` matrix

The engine-out nitric oxide and nitrogen dioxide emissions are a function of commanded engine torque and engine speed, EO NOx = ƒ(T_cmd, N), where:

EO NOx is engine-out nitric oxide and nitrogen dioxide emissions, in kg/s.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.

Dependencies

To enable this parameter, clear Input engine temperature.

`Plot EO NOx map` — Plot table
button

Click to plot table.

Dependencies

To enable this parameter, clear Input engine temperature.

`EO NOx map, f_nox_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

The engine-out nitric oxide and nitrogen dioxide emissions are a function of commanded engine torque, engine speed, and engine temperature, EO NOx = ƒ(T_cmd, N, Temp_Eng), where:

EO NOx is engine-out nitric oxide and nitrogen dioxide emissions, in kg/s.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.
Temp_Eng is engine temperature, in K.

Dependencies

To enable this parameter, select Input engine temperature.

CO2

`EO CO2 map, f_co2` — 2D lookup table
`M`-by-`N` matrix

The engine-out carbon dioxide emissions are a function of commanded engine torque and engine speed, EO CO2 = ƒ(T_cmd, N), where:

EO CO2 is engine-out carbon dioxide emissions, in kg/s.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.

Dependencies

To enable this parameter, clear Input engine temperature.

`Plot CO2 map` — Plot table
button

Click to plot table.

Dependencies

To enable this parameter, clear Input engine temperature.

`EO CO2 map, f_co2_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

The engine-out carbon dioxide emissions are a function of commanded engine torque, engine speed, and engine temperature, EO CO2 = ƒ(T_cmd, N, Temp_Eng), where:

EO CO2 is engine-out carbon dioxide emissions, in kg/s.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.
Temp_Eng is engine temperature, in K.

Dependencies

To enable this parameter, select Input engine temperature.

PM

`EO PM map, f_pm` — 2D lookup table
`M`-by-`N` matrix

The engine-out particulate matter emissions are a function of commanded engine torque and engine speed, where:

EO PM is engine-out PM emissions, in kg/s.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.

Dependencies

To enable this parameter, clear Input engine temperature.

`Plot EO PM map` — Plot table
button

Click to plot table.

Dependencies

To enable this parameter, clear Input engine temperature.

`EO PM map, f_pm_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

The engine-out particulate matter emissions are a function of commanded engine torque, engine speed, and engine temperature, where:

EO PM is engine-out PM emissions, in kg/s.
T_cmd is commanded engine torque, in N·m.
N is engine speed, in rpm.
Temp_Eng is engine temperature, in K.

Dependencies

To enable this parameter, select Input engine temperature.

Model Examples

Conventional Vehicle Reference Application

Simulate a full vehicle model with an internal combustion engine, transmission, and associated powertrain control algorithms. Use for powertrain matching analysis and component selection, control and diagnostic algorithm design, and hardware-in-the-loop (HIL) testing.

Open Example

SI Engine Dynamometer Reference Application

Simulate a SI engine plant and controller connected to a dynamometer with a tailpipe emission analyzer. Use to calibrate, validate, and optimize the SI engine controller and plant model parameters before integrating the engine with the vehicle model.

Open Example

Documentation

Mapped SI Engine

Description

Virtual Calibration

Cylinder Air Mass

Turbocharger Lag

Fuel Flow

Power Accounting

Ports

Input

TrqCmd — Commanded torque scalar

EngSpd — Engine speed scalar

EngTemp — Engine temperature scalar

Dependencies

Output

Info — Bus signal bus

EngTrq — Engine brake torque scalar

Parameters

Block Options

Include turbocharger lag effect — Increase time constant off (default)

Dependencies

Input engine temperature — Create input port off (default) | on

Configuration

Calibrate Maps — Calibrate tables with measured data selection

Dependencies

Breakpoints for commanded torque, f_tbrake_t_bpt — Breakpoints 1-by-M vector

Breakpoints for engine speed input, f_tbrake_n_bpt — Breakpoints 1-by-N vector

Breakpoints for temperature input, f_tbrake_engtmp_bpt — Breakpoints [233.15 273.15 373.15] (default) | 1-by-L vector

Dependencies

Number of cylinders, NCyl — Number 4 (default) | scalar

Crank revolutions per power stroke, Cps — Crank revolutions 2 (default) | scalar

Total displaced volume, Vd — Volume 0.0015 (default) | scalar

Fuel lower heating value, Lhv — Heating value 45e6 (default) | scalar

Fuel specific gravity, Sg — Specific gravity 0.745 (default) | scalar

Ideal gas constant air, Rair — Constant 287 (default) | scalar

Air standard pressure, Pstd — Pressure 101325 (default) | scalar

Air standard temperature, Tstd — Temperature 293.15 (default) | scalar

Boost torque line, f_tbrake_bst — Boost lag 1-by-M vector

Dependencies

Time constant below boost line — Time constant below 0.2 (default) | scalar

Dependencies

Rising torque boost time constant, tau_bst_rising — Rising time constant 1.5 (default) | scalar

Dependencies

Falling torque boost time constant, tau_bst_falling — Falling time constant 1 (default) | scalar

Dependencies

Power

Brake torque map, f_tbrake — 2D lookup table M-by-N matrix

Plot brake torque map — Plot table button

Dependencies

Brake torque map, f_tbrake_3d — 3D lookup table M-by-N-by-L array

Dependencies

Air

Air mass flow map, f_air — 2D lookup table M-by-N matrix

Dependencies

Plot air mass map — Plot table button

Dependencies

Air mass flow map, f_air_3d — 3D lookup table M-by-N-by-L array

Dependencies

Fuel

Fuel flow map, f_fuel — 2D lookup table M-by-N matrix

Dependencies

Plot fuel flow map — Plot table button

Dependencies

Fuel flow map, f_fuel_3d — 3D lookup table M-by-N-by-L array

Dependencies

Temperature

Exhaust temperature map, f_texh — 2D lookup table M-by-N matrix

Dependencies

Plot exhaust temperature map — Plot table button

Dependencies

Exhaust temperature map, f_texh_3d — 3D lookup table array

Dependencies

Efficiency

BSFC map, f_eff — 2D lookup table M-by-N-by-L array

Dependencies

Plot BSFC map — Plot table button

Dependencies

BSFC map, f_eff_3d — 3D lookup table M-by-N-by-L array

Dependencies

HC

`TrqCmd` — Commanded torque
`scalar`

`EngSpd` — Engine speed
`scalar`

`EngTemp` — Engine temperature
`scalar`

`Info` — Bus signal
bus

`EngTrq` — Engine brake torque
`scalar`

`Include turbocharger lag effect` — Increase time constant
`off` (default)

`Input engine temperature` — Create input port
`off` (default) | `on`

`Calibrate Maps` — Calibrate tables with measured data
`selection`

`Breakpoints for commanded torque, f_tbrake_t_bpt` — Breakpoints
`1`-by-`M` vector

`Breakpoints for engine speed input, f_tbrake_n_bpt` — Breakpoints
`1`-by-`N` vector

`Breakpoints for temperature input, f_tbrake_engtmp_bpt` — Breakpoints
`[233.15 273.15 373.15]` (default) | `1`-by-`L` vector

`Number of cylinders, NCyl` — Number
`4` (default) | `scalar`

`Crank revolutions per power stroke, Cps` — Crank revolutions
`2` (default) | `scalar`

`Total displaced volume, Vd` — Volume
`0.0015` (default) | `scalar`

`Fuel lower heating value, Lhv` — Heating value
`45e6` (default) | `scalar`

`Fuel specific gravity, Sg` — Specific gravity
`0.745` (default) | `scalar`

`Ideal gas constant air, Rair` — Constant
`287` (default) | `scalar`

`Air standard pressure, Pstd` — Pressure
`101325` (default) | `scalar`

`Air standard temperature, Tstd` — Temperature
`293.15` (default) | `scalar`

`Boost torque line, f_tbrake_bst` — Boost lag
`1`-by-`M` vector

`Time constant below boost line` — Time constant below
`0.2` (default) | `scalar`

`Rising torque boost time constant, tau_bst_rising` — Rising time constant
`1.5` (default) | `scalar`

`Falling torque boost time constant, tau_bst_falling` — Falling time constant
`1` (default) | `scalar`

`Brake torque map, f_tbrake` — 2D lookup table
`M`-by-`N` matrix

`Plot brake torque map` — Plot table
button

`Brake torque map, f_tbrake_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

`Air mass flow map, f_air` — 2D lookup table
`M`-by-`N` matrix

`Plot air mass map` — Plot table
button

`Air mass flow map, f_air_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

`Fuel flow map, f_fuel` — 2D lookup table
`M`-by-`N` matrix

`Plot fuel flow map` — Plot table
button

`Fuel flow map, f_fuel_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

`Exhaust temperature map, f_texh` — 2D lookup table
`M`-by-`N` matrix

`Plot exhaust temperature map` — Plot table
button

`Exhaust temperature map, f_texh_3d` — 3D lookup table
`array`

`BSFC map, f_eff` — 2D lookup table
`M`-by-`N`-by-`L` array

`Plot BSFC map` — Plot table
button

`BSFC map, f_eff_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

`EO HC map, f_hc` — 2D lookup table
`M`-by-`N` matrix

`Plot EO HC map` — Plot table
button

`EO HC map, f_hc_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

`EO CO map, f_co` — 2D lookup table
`M`-by-`N` matrix

`Plot EO CO map` — Plot table
button

`EO HC map, f_hc_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

`EO NOx map, f_nox` — 2D lookup table
`M`-by-`N` matrix

`Plot EO NOx map` — Plot table
button

`EO NOx map, f_nox_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

`EO CO2 map, f_co2` — 2D lookup table
`M`-by-`N` matrix

`Plot CO2 map` — Plot table
button

`EO CO2 map, f_co2_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

`EO PM map, f_pm` — 2D lookup table
`M`-by-`N` matrix

`Plot EO PM map` — Plot table
button

`EO PM map, f_pm_3d` — 3D lookup table
`M`-by-`N`-by-`L` array

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.