Name

Type

Units

Vehicle Type

Description

cyc_description

char

–

all

one line description of the drive cycle

cyc_proprietary

Boolean

–

all

0= public data, 1= restricted access

cyc_validation

char

–

all

0= no validation, 1= confirmed agreement with source data, 2= agrees with source data, and source data collection methods have been verified

cyc_version

char

–

all

ADVISOR version number for which data file was created

cyc_filter_bool

Boolean

–

all

1=not a max acceleration test (filter), 0=max acceleration test (don’t filter)

cyc_avg_time

scalar

s

all

Dt over which to smooth drive cycle requests

cyc_mph

matrix

s, mph

all

time in first column vs. vehicle speed in second column defining drive cycle

cyc_grade

matrix(nx2)

m,decimal

all

distance in first column, decimal representation of road grade, i.e. 6% grade=0.06 in second column

cyc_cargo_mass

matrix(nx2)

m, kg

all

distance in first column, vehicle cargo mass in second column (this is mass added to or subtracted from veh_mass as a function of distance–represents loading/unloading of vehicle)

cyc_elevation_init

scalar

m

all

the initial elevation at the start of the drive cycle

Name

Type

Units

Vehicle Type

Description

ess_description

char

–

par/ser

text string description of the ESS

ess_proprietary

Boolean

–

par/ser

0= public data, 1= restricted access

ess_validation

char

–

par/ser

0= no validation, 1= confirmed agreement with source data, 2= agrees with source data, and source data collection methods have been verified

ess_version

char

–

par/ser

ADVISOR version number for which data file was created

ess_coulombic_eff

scalar

–

par/ser

average Coulombic efficiency of the energy storage system (ESS)

ess_init_soc

scalar

–

par/ser

initial state of charge of the ESS

ess_max_ah_cap

scalar

Ah

par/ser

maximum A-h capacity the ESS can have, no matter how slowly it is drained

ess_module_mass

scalar

kg

par/ser

mass of one energy storage module

ess_module_num

scalar

–

par/ser

number of modules in a pack; ASSUMED TO BE STRUNG IN SERIES

ess_min_volts

scalar

V

par/ser

minimum battery operating voltage, not to be exceeded during discharge

ess_max_volts

scalar

V

par/ser

maximum battery operating voltage, not to be exceeded during charge

ess_r_chg

matrix

ohms

par/ser

module’s resistance to being charged; indexed by ess_soc and ess_tmp

ess_r_dis

matrix

ohms

par/ser

module’s resistance to being discharged; indexed by ess_soc and ess_tmp

ess_soc

vector

–

par/ser

vector of SOCs used to index other ESS variables

ess_tmp

vector

C

par/ser

vector of temperatures used to index other ESS variables

ess_voc

matrix

volts

par/ser

module’s open-circuit voltage; indexed by ess_soc and ess_tmp

ess_th_calc

Boolean

–

all

0=no ess thermal calculations, 1=do calculations

ess_mod_cp

scalar

J/kgK

all

ave heat capacity of module

ess_set_tmp

scalar

C

all

thermostat temp of module when cooling fan comes on

ess_mod_sarea

scalar

m^2

all

total module surface area exposed to cooling air 

ess_mod_airflow

scalar

kg/s

all

cooling air mass flow rate across module 

ess_mod_flow_area

scalar

m^2

all

cross-sec flow area for cooling air per module 

ess_mod_case_thk

scalar

m

all

thickness of module case (typ from Optima)

ess_mod_case_th_cond

scalar

W/mK

all

thermal conductivity of module case material 

ess_air_vel

scalar

m/s

all

ave velocity of cooling air

ess_air_htcoef

scalar

W/m^2K

all

cooling air heat transfer coef.

ess_th_res_on

scalar

K/W

all

tot thermal res key on

ess_th_res_off

scalar

K/W

all

tot thermal res key off (cold soak)

battery_mass

scalar

kg

Insight

the mass of the batteries

ess_mod_init_tmp

scalar

C

all

the initial temperature of the energy storage system module

Name

Type

Units

Vehicle Type

Description

ess_description

char

–

par/ser

text string description of the ESS

ess_proprietary

Boolean

–

par/ser

0= public data, 1= restricted access

ess_validation

char

–

par/ser

0= no validation, 1= confirmed agreement with source data, 2= agrees with source data, and source data collection methods have been verified

ess_version

char

–

par/ser

ADVISOR version number for which data file was created

ess_init_soc

scalar

–

par/ser

initial state of charge of the ESS

ess_max_ah_cap

scalar

Ah

par/ser

maximum A-h capacity the ESS can have, no matter how slowly it is drained

ess_module_mass

scalar

kg

par/ser

mass of one energy storage module

ess_module_num

scalar

–

par/ser

number of modules in a pack; ASSUMED TO BE STRUNG IN SERIES

ess_min_volts

scalar

V

par/ser

minimum battery operating voltage, not to be exceeded during discharge

ess_max_volts

scalar

V

par/ser

maximum battery operating voltage, not to be exceeded during charge

ess_cb

matrix

Farads

par/ser

module’s main capacitance, represents the ample capability of the battery to store charge chemically; indexed by ess_tmp

ess_cc

matrix

Farads

par/ser

module’s secondary capacitance, represents the surface effects of a spiral-wound cell, e.g. the limiting behavior of a battery to deliver current based on time constants associated with the diffusion of materials and chemical reactions; indexed by ess_tmp

ess_re

matrix

ohms

par/ser

resistance Re (see schematic in documentation), resistance associated with capacitor Cb; indexed by ess_soc and ess_tmp

ess_rc

matrix

ohms

par/ser

resistance Rc (see schematic in documentation), resistance associated with capacitor Cc; indexed by ess_soc and ess_tmp

ess_rt

matrix

ohms

par/ser

resistance Rt (see schematic in documentation), represents terminal resistance; indexed by ess_soc and ess_tmp

ess_voc

matric

volts

par/ser

module’s open-circuit voltage; indexed by ess_soc and ess_tmp.  Used to correlate voltage on Cb to SOC

ess_soc

vector

–

par/ser

vector of SOCs used to index other ESS variables

ess_tmp

vector

C

par/ser

vector of temperatures used to index other ESS variables

ess_th_calc

Boolean

–

all

0=no ess thermal calculations, 1=do calculations

ess_mod_cp

scalar

J/kgK

all

ave heat capacity of module

ess_set_tmp

scalar

C

all

thermostat temp of module when cooling fan comes on

ess_mod_sarea

scalar

m^2

all

total module surface area exposed to cooling air 

ess_mod_airflow

scalar

kg/s

all

cooling air mass flow rate across module 

ess_mod_flow_area

scalar

m^2

all

cross-sec flow area for cooling air per module 

ess_mod_case_thk

scalar

m

all

thickness of module case (typ from Optima)

ess_mod_case_th_cond

scalar

W/mK

all

thermal conductivity of module case material 

ess_air_vel

scalar

m/s

all

ave velocity of cooling air

ess_air_htcoef

scalar

W/m^2K

all

cooling air heat transfer coef.

ess_th_res_on

scalar

K/W

all

tot thermal res key on

ess_th_res_off

scalar

K/W

all

tot thermal res key off (cold soak)

battery_mass

scalar

kg

Insight

the mass of the batteries

ess_mod_init_tmp

scalar

C

all

the initial temperature of the energy storage system module

Name

Type

Units

Vehicle Type

Description

ess_max_p

vector (2 units long)

W

veh w/ nnet battery ess

power corresponding to SOC values supplied in ess_max_p_soc. Used for maximum power calculation in neural network battery model (see block diagram advisor_ess_options/energy storage <ess> nnet/max pack pwr (W) in the ‘max power’ block)

ess_max_p_soc

vector (2 units long)

W

veh w/ nnet battery ess

minimum and maximum state of charge used for maximum power calculation in neural network battery model (see block diagram advisor_ess_options/energy storage <ess> nnet/max pack pwr (W) in the ‘max power’ block)

ess_MMi

matrix (2x2)

[W,W;–;–]

veh w/ nnet battery ess

minimum and maximum input values for power requested and SOC:
[min power requested, max power requested;
corresponding SOC for min power, corresponding SOC for max power]

ess_MMo

matrix (2x2)

[A,A;V,V]

veh w/ nnet battery ess

minimum and maximum outputs: current, voltage (same layout as ess_MMi)

Name

Type

Units

Vehicle Type

Description

ess_aao2

scalar

–

veh w/ fund. battery ess

anodic charge transfer coefficient for O₂ evolution at positive electrode

ess_aapb

scalar

–

veh w/ fund. battery ess

anodic charge transfer coefficient for Pb electrode

ess_aapbo2

scalar

–

veh w/ fund. battery ess

anodic charge transfer coefficient for PbO₂ electrode

ess_ach2

scalar

–

veh w/ fund. battery ess

cathodic charge transfer coefficient for H₂ evolution at negative electrode

ess_aco2

scalar

–

veh w/ fund. battery ess

cathodic charge transfer coefficient for O₂ reaction at positive electrode

ess_acpb

scalar

–

veh w/ fund. battery ess

cathodic charge transfer coefficient for Pb electrode

ess_acpbo2

scalar

–

veh w/ fund. battery ess

cathodic charge transfer coefficient for PbO₂ electrode

ess_aopb

scalar

(cm-1)

veh w/ fund. battery ess

initial internal surface area for Pb electrode

ess_aopbo2

scalar

(cm-1)

veh w/ fund. battery ess

initial internal surface area for PbO₂ electrode

ess_c2ref

scalar

mole/cm3

veh w/ fund. battery ess

reference acid concentration

ess_cacid

scalar

M

veh w/ fund. battery ess

initial concentration of sulfuric acid in the cell

ess_cap

scalar

A*hr

veh w/ fund. battery ess

rated capacity of the cell

ess_dUdT

scalar

–

veh w/ fund. battery ess

temperature coefficient for cell potential

ess_ech2rf

scalar

A/cm^2

veh w/ fund. battery ess

reference exchange current density, H₂ electrode at 25^oC

ess_ecnref

scalar

A/cm^2

veh w/ fund. battery ess

reference exchange current density, Pb electrode at 25^o C

ess_eco2rf

scalar

A/cm^2

veh w/ fund. battery ess

reference exchange current density, O₂ at 25^o C

ess_ecpref

scalar

A/cm^2

veh w/ fund. battery ess

reference exchange current density, PbO₂ electrode at 25^o C

ess_egass

scalar

–

veh w/ fund. battery ess

volume fraction of gas in separator

ess_elgel

scalar

cm

veh w/ fund. battery ess

length of the unrolled electrode

ess_elpb

scalar

cm

veh w/ fund. battery ess

thickness of the negative electrode

ess_elpbo2

scalar

cm

veh w/ fund. battery ess

thickness of the positive electrode

ess_elsep

scalar

cm

veh w/ fund. battery ess

thickness of the separator

ess_epb

scalar

–

veh w/ fund. battery ess

volume fraction of active material in negative electrode

ess_epbo2

scalar

–

veh w/ fund. battery ess

volume fraction of active material in positive electrode

ess_esep

scalar

–

veh w/ fund. battery ess

separator volume fraction

ess_fc

scalar

C/equiv

veh w/ fund. battery ess

Faraday’s constant

ess_fo2

scalar

–

veh w/ fund. battery ess

fraction of O2 that recombines at negative electrode

ess_gexn

scalar

–

veh w/ fund. battery ess

expansion coefficient for nodes in the negative electrode (ratio of adjacent cells, number greater than 1 concentrates nodes at electrode front)

ess_gexp

scalar

–

veh w/ fund. battery ess

expansion coefficient for nodes in the positive electrode (ratio of adjacent cells; number greater than 1 concentrates nodes at electrode front)

ess_gvoln

scalar

–

veh w/ fund. battery ess

volume fraction of supporting grid in the negative electrode

ess_gvolp

scalar

–

veh w/ fund. battery ess

volume fraction of supporting grid in the positive electrode

ess_htel

scalar

cm

veh w/ fund. battery ess

height of the unrolled electrode

ess_n

scalar

–

veh w/ fund. battery ess

number of coupled equations

ess_ncpmod

scalar

–

veh w/ fund. battery ess

number of cells per module

ess_nmppk

scalar

–

veh w/ fund. battery ess

number of modules per pack

ess_npb

scalar

–

veh w/ fund. battery ess

number of computational nodes in negative electrode(lead)

ess_npbo2

scalar

–

veh w/ fund. battery ess

number of computational nodes in positive electrode (lead oxide)

ess_nsep

scalar

–

veh w/ fund. battery ess

number of computational nodes in separator

ess_pneg

scalar

–

veh w/ fund. battery ess

exponent for area correction, Pb electrode

ess_ppos

scalar

–

veh w/ fund. battery ess

exponent for area correction, PbO₂ electrode

ess_qneg

scalar

C/cm^3

veh w/ fund. battery ess

theoretical capacity of negative electrode

ess_qpos

scalar

C/cm^3

veh w/ fund. battery ess

theoretical capacity of positive electrode

ess_ratio

scalar

–

veh w/ fund. battery ess

ratio of gas to liquid volume fractions in the electrodes

ess_relax

scalar

–

veh w/ fund. battery ess

relaxation factor for iterative solution of coupled equations (0=no update, 1 = no relaxation)

ess_rgas

scalar

J/mole/K

veh w/ fund. battery ess

gas constant

ess_rkcsatn

scalar

–

veh w/ fund. battery ess

mass transfer parameter for negative electrode

ess_rkcsatp

scalar

–

veh w/ fund. battery ess

mass transfer parameter for positive electrode

ess_rtop

scalar

ohms

veh w/ fund. battery ess

resistance to account for current collection and tab

ess_spb

scalar

S/cm

veh w/ fund. battery ess

electronic conductivity of lead

ess_spbo2

scalar

S/cm

veh w/ fund. battery ess

electronic conductivity of lead dioxide

ess_tcurmx

scalar

A

veh w/ fund. battery ess

maximum motor current

ess_theta

scalar

–

veh w/ fund. battery ess

factor used to determine time averaging (0 = fully explicit, 0.5 = Crank-Nicholson, 1= fully implicit)

ess_tpb

scalar

–

veh w/ fund. battery ess

exponent on volume fraction for tortuosity correction in negative electrode

ess_tpbo2

scalar

–

veh w/ fund. battery ess

exponent on volume fraction for tortuosity correction in positive electrode

ess_tplus

scalar

–

veh w/ fund. battery ess

transference number for hydrogen ion

ess_tsep

scalar

–

veh w/ fund. battery ess

exponent on volume fraction for tortuosity correction in separator

ess_tstep

scalar

s

veh w/ fund. battery ess

initial value for time step (not needed-remove later) 

ess_uh2

scalar

V

veh w/ fund. battery ess

equilibrium voltage for H₂ vs. Pb

ess_uo2

scalar

V

veh w/ fund. battery ess

equilibrium voltage for O₂ vs. Pb

ess_ve

scalar

(cm^3)/mole

veh w/ fund. battery ess

partial molar volume of acid

ess_vmax

scalar

V

veh w/ fund. battery ess

maximum voltage

ess_vmin

scalar

V

veh w/ fund. battery ess

minimum voltage

ess_vo

scalar

(cm^3)/mole

veh w/ fund. battery ess

partial molar volume of water

ess_vpb

scalar

(cm^3)/mole

veh w/ fund. battery ess

molar volume of Pb

ess_vpbo2

scalar

(cm^3)/mole

veh w/ fund. battery ess

molar volume of PbO₂

ess_vpbso4

scalar

(cm^3)/mole

veh w/ fund. battery ess

molar volume of PbSO₄

Name

Type

Units

Vehicle Type

Description

fc_description

char

–

all

text string description of the fuel converter

fc_proprietary

boolean

–

all

0= public data, 1= restricted access

fc_validation

char

–

all

0= no validation, 1= confirmed agreement with source data, 2= agrees with source data, and source data collection methods have been verified

fc_version

char

–

all

ADVISOR version number for which data file was created

fc_fuel_type

char

–

all

description of fuel type

fc_disp

scalar

L

all(~fuel cell)

engine size (cyl displacement)

fc_emis

boolean

–

all

0= no emissions data available 1= emissions data available

fc_map_spd

vector

rad/s

all(~fuel cell)

engine speed range

fc_map_trq

vector

N*m

all(~fuel cell)

engine torque range

fc_fuel_map

matrix

g/s

all

fuel use indexed by fc_map_spd and fc_map_trq

fc_co_map

matrix

g/s

all

engine out CO indexed by fc_map_spd and fc_map_trq

fc_hc_map

matrix

g/s

all

engine out HC indexed by fc_map_spd and fc_map_trq

fc_nox_map

matrix

g/s

all

engine out NOx indexed by fc_map_spd and fc_map_trq

fc_pm_map

matrix

g/s

all

engine out PM indexed by fc_map_spd and fc_map_trq

fc_extmp_map

matrix

C

all

engine-out exhaust gas temperature indexed by fc_map_spd and fc_map_trq

fc_exflow_map

matrix

g/s

all

exhaust gas mass flow rate indexed by fc_map_spd and fc_map_trq

fc_co2map

matrix

g/s

all

exhaust carbon dioxide flow rate indexed by fc_map_spd and fc_map_trq

fc_ct_trq

vector

N*m

all(~fuel cell)

closed throttle torque indexed by fc_map_spd

fc_fuel_den

scalar

g/L

all

fuel density

fc_fuel_lhv

scalar

J/g

all

lower heating value of the fuel

fc_inertia

scalar

kg*m^2

all(~fuel cell)

rotational inertia of the engine

fc_max_trq

vector

N*m

all(~fuel cell)

maximum torque output indexed by fc_map_spd

fc_spd_scale

scalar

–

all

scaling factor for speed range

fc_trq_scale

scalar

–

all

scaling factor for torque range

fc_pwr_scale

scalar

–

all

scaling factor for power=fc_trq_scale*fc_spd_scale

fc_max_pwr

scalar

kW

all

engine peak power in kW

fc_coolant_init_tmp

scalar

C

all

initial coolant temperature

fc_mass

scalar

kg

all

mass of the fuel converter and fuel system

fc_base_mass

scalar

kg

all

mass of the base engine (block)

fc_acc_mass

scalar

kg

all

mass of engine accessories such as turbo, radiator, SLI battery, etc.

fc_fuel_mass

scalar

kg

all

mass of fuel and fuel tank

fc_ex_pwr_frac

1x2 vector

–

all

[ low speed fraction    high speed fraction] 
frac of waste heat that goes to exhaust(used to estimate fc_extmp_map if not provided)

fc_tstat

scalar

C

all

engine coolant thermostat set temperature (typically 95 +/- 5 C)

fc_cp

scalar

J/kg/K

all

ave cp of engine (iron=500, Al or Mg=1000)

fc_h_cp

scalar

J/kg/K

all

ave cp of hood & engine compartment (iron=500, Al or Mg = 1000)

fc_ext_sarea

scalar

m^2

all

exterior surface area of engine

fc_hood_sarea

scalar

m^2

all

surface area of hood/eng. compartment

fc_emisv

scalar

–

all

eff emissivity of engine ext surface to hood int surface

fc_hood_emisv

scalar

–

all

emissivity hood ext

fc_h_air_flow

scalar

kg/s

all

heater air flow rate (140 cfm=0.07)

fc_cl2h_eff

scalar

–

all

ave cabin heater HX eff (based on air side)

fc_c2i_th_cond

scalar

W/K

all

conductance btwn engine cycl & int

fc_i2x_th_cond

scalar

W/K

all

conductance btwn engine int & ext

fc_h2x_th_cond

scalar

W/K

all

conductance btwn engine & engine compartment

fc_eff_scale

scalar

–

all

scale factor for engine efficiency

fc_pwr_map

vector

W

fuel cell

net power out of the fuel cell used to index fc_fuel_map for power vs efficiency fuel cell model

fc_I_map

vector

amps/m^2

fuel cell

cell current density of the fuel cell used to index the fc_fuel_map for the polarization curve fuel cell model

fc_V_map

vector

volts

fuel cell

cell voltage indexed by current density for the polarization curve fuel cell model

fc_fuel_pump_pwr

vector

W

fuel cell

fuel pump power required indexed by fuel flow (fc_fuel _pump_map) for the polarization curve model when using liquid fuels

fc_fuel_pump_map

vector

g/s

fuel cell

fuel pump fuel flow  for the polarization curve model when using liquid fuels

fc_air_comp_map

vector

g/s

fuel cell

air compressor  flow for the polarization curve model when using pressurized systems

fc_air_comp_pwr

vector

W

fuel cell

air compressor power required indexed by air flow (fc_air comp_map) for the polarization curve model when using pressurized systems

fc_water_pump_map

vector

g/s

fuel cell

water pump flow for the polarization curve model when using liquid fuels

fc_water_pump_pwr

vector

W

fuel cell

water pump power required indexed by water flow (fc_water_pump_map) for the polarization curve model when using liquid fuels

fc_coolant_pump_pwr

vector

W

fuel cell

coolant pump power required indexed by coolant flow (fc_coolant _pump_map) for the polarization curve model 

fc_coolant_pump_map

vector

g/s

fuel cell

coolant flow (fc_fuel _pump_map) for the polarization curve model 

fc_cell_num

scalar

–

fuel cell

number of cells per stack

fc_stack_num

scalar

–

fuel cell

number of stacks per parallel string

fc_string_num

scalar

–

fuel cell

number of parallel strings

fc_cell_area

scalar

m^2

fuel cell

active area per cell

fc_fuel_cell_model

scalar

–

fuel cell

model type identifier 1== polarization model, 2== power vs efficiency model, 3== GCTool-based model

fc_fuel_air_ratio

scalar

g/g

fuel cell

mass based fuel to air ratio used in polarization curve model to determine air flow requirement based on fuel requirement

fc_fuel_water_ratio

scalar

g/g

fuel cell

mass based fuel to water ratio used in polarization curve model to determine water flow requirement based on fuel requirement

fc_c_init_tmp

scalar

C

all with fc

initial temperature of the engine cylinder

fc_h_init_tmp

scalar

C

all with fc

initial hood temperature

fc_i_init_tmp

scalar

C

all with fc

initial engine interior temperature

fc_x_init_tmp

scalar

C

all with fc

initial engine exterior temperature

fc_coolant_cp

scalar

J/(g*K)

fuel cell

coolant specific heat capacity

fc_coolant_flow_rate

scalar

g/s

fuel cell

fixed coolant flow rate

Name

Type

Units

Vehicle Type

Description

ptc_description

char

–

all

one line description for the ptc

ptc_proprietary

char

–

all

0= public data, 1= restricted access

ptc_validation

char

–

all

0= no validation, 1= confirmed agreement with source data, 2= agrees with source data, and source data collection methods have been verified

ptc_version

char

–

all

ADVISOR version number for which data file was created

Name

Type

Units

Vehicle Type

Description

tx_mass

scalar

kg

all

mass of the transmission=gb_mass+fd_mass

tx_pg_r

scalar

–

prius_jpn

number of teeth on ring gear of planetary gear system

tx_pg_s

scalar

–

prius_jpn

number of teeth on sun gear of planetary gear system

tx_validated

Boolean

–

all

flag: 0=> no validation, 1=> data agrees with source data, 2=> data matches source data and data collection methods have been verified

tx_validation

Boolean

–

all

flag: 0=> no validation, 1=> data agrees with source data, 2=> data matches source data and data collection methods have been verified

tx_type

char

–

all

the type of transmission: e.g., ‘manual 1 speed’, ‘manual 5 speed’, ‘cvt’, ‘auto 4 speed’

tx_version

scalar

–

all

ADVISOR version number for which data file was created

tx_eff_scale

scalar

–

all

another term for gb_eff_scale

tx_proprietary

Boolean

–

all

0=> non-proprietary, 1=> proprietary, do not distribute

tx_description

char

–

all

text string description of transmission

tx_map_spd

vector

rad/s

all

an array indexing rows of tx_eff_map with transmisison output speed

tx_map_trq

vector

Nm

all

an array indexing columns of tx_eff_map with transmisison output torque

tx_eff_map

3d matrix

–

all

efficiency map of transmission efficiency by output speed, output torque, and gear number

tx_spd_dep_upshift

2d matrix
(n x 2)

[m/s,
gear num]

all except
CVT and
Prius

a two column matrix with speed (m/s) in the first column and gear number in the second column. This matrix is used as a lookup table for gear duing upshifting. Note: the information should be presented as a step-function (e.g., [0 1; 10 1; 10 2; 20 2])

tx_spd_dep_dnshift

2d matrix
(n x 2)

[m/s,
gear num]

all except
CVT and
Prius

Similar to tx_spd_dep_upshift. This matrix is used as a lookup table for gear duing downshifting. Note: the information should be presented as a step-function (e.g., [0 1; 10 1; 10 2; 20 2])

tx_speed_dep

Boolean

–

all except
CVT and
Prius

a flag which indicates if speed-dependent shifting or default Advisor control strategy based shifting should be used. a ‘1’ indicates speed dependent shifting while a ‘0’ indicates default control strategy. 

Name

Type

Units

Vehicle Type

Description

fd_description

char

–

all

text string description of the final drive

fd_proprietary

char

–

all

0= public data, 1= restricted access

fd_validation

char

–

all

0= no validation, 1= confirmed agreement with source data, 2= agrees with source data, and source data collection methods have been verified

fd_version

char

–

all

ADVISOR version number for which data file was created

fd_inertia

scalar

kg*m^2

all

rotational inertia of the final drive

fd_loss

scalar

N*m

all

torque loss of final drive

fd_ratio

scalar

–

all

gear ratio of final drive

fd_mass

scalar

kg

all

mass of final drive - 1990 Taurus, OTA report

Name

Type

Units

Vehicle Type

Description

gb_description

char

–

all

text description of the gearbox

gb_proprietary

Boolean

–

all

0= public data, 1= restricted access

gb_validation

scalar

–

all

0= no validation, 1= confirmed agreement with source data, 2= agrees with source data, and source data collection methods have been verified

gb_version

scalar

–

all

ADVISOR version number for which gearbox data was created

gb_gearX_dnshift_load

vector

–

all

fraction of max load at current speed at which downshift is requested in gear X

gb_gearX_dnshift_spd

vector

rad/s

all

speed at which downshift is requested in gear X

gb_gearX_upshift_load

vector

–

all

fraction of max load at current speed at which upshift is requested in gear X

gb_gearX_upshift_spd

vector

rad/s

all

speed at which upshift is requested in gear X

gb_gears_num

scalar

–

all

number of gears in gearbox

gb_inertia

scalar

kg*m^2

all

rotational inertia of the gearbox

gb_loss_const

scalar

W

all

used in equation 1

gb_loss_input_spd_coeff

scalar

J/rad

all

used in equation 1

gb_loss_input_trq_coeff

scalar

W/(N*m)

all

used in equation 1

gb_loss_output_pwr_coeff

scalar

–

all

used in equation 1

gb_loss_output_spd_coeff

scalar

J/rad

all

used in equation 1

gb_loss_output_trq_coeff

scalar

W/(N*m)

all

used in equation 1

gb_ratio

vector

–

all

available gear ratios of the gearbox

gb_shift_delay

scalar

s

all

duration of a shift, no torque is transmitted

gb_eff_scale

scalar

–

all

gb_eff_scale is not used directly in modeling and should always be equal to one. It is a variable used for default scaling and is used for initialization purposes

gb_mass

scalar

kg

all

mass of the gearbox (transmission and control boxes without fluids)

gb_spd_scale

scalar

–

all

speed scaling parameter; used to scale gb_map_spd to simulate a faster or slower running gear box

gb_trq_scale

scalar

–

all

torque scaling parameter; used to scale gb_map_trq to simulate a higher or lower torque gb

gb_dnshift_load

vector

–

all non-CVT

a vector of loads (0 to 1) for down-shifting commands (see lib_controls block diagram). (the first element is for 1st gear, etc.)

gb_dnshift_spd

vector

rad/s

all non-CVT

a vector of speeds (rad/s) for down-shifting commands (see lib_controls block diagram). (the first element is for 1st gear, etc.)

gb_upshift_load

vector

–

all non-CVT

a vector of loads (0 to 1) for up-shifting commands (see lib_controls block diagram). (the first element is for 1st gear, etc.)

gb_upshift_spd

vector

rad/s

all non-CVT

a vector of speeds (rad/s) for up-shifting commands (see lib_controls block diagram). (the first element is for 1st gear, etc.)

gb_validated

scalar (flag)

–

all

0=> no validation, 1=> confirmed agreement with source data, 2=> agrees with source data, and data collection methods have been verified

Name

Type

Units

Vehicle Type

Description

htc_k

vector

rad/s/(N*m)^0.5

conv

torque converter’s K-factor

htc_k_coast

scalar

rad/s/(N*m)^0.5

conv

K factor of the hydraulic torque converter for coasting, w_in/(T_in)^0.5; only needs be defined for auto-transmission

htc_k_adv

scalar

rad/s/(N*m)^0.5

conv

advisor K factor for the hydraulic torque converter defined as w_out/(T_out)^0.5, only needs be defined for auto-transmission

htc_k_adv_coast

scalar

rad/s/(N*m)^0.5

conv

advisor K factor defined as w_out/(T_out)^0.5, for coasting, only needs be defined for auto-transmission

htc_sr

vector

–

conv

torque converter speed ratio, indexed by htc_k

htc_tr

vector

–

conv

torque converter torque ratio, indexed by htc_k

htc_inertia

scalar

N*m-s^2

conv

inertia of the hydraulic torque converter, used for automatic transmissions

htc_lockup

vector

–

conv

htc_lockup(i)==’when in gear i, lock up HTC’; only needs be defined for auto-transmission

htc_max_coast_tr

scalar

–

conv

maximum torque ratio while coasting

htc_min_coast_tr

scalar

–

conv

the minimum torque ratio while coasting

htc_sr_coast

vector

–

conv

the speed ratio of the hydraulic torque converter for coasting. sr = w_out/w_in

htc_tr_coast

vector

–

conv

the torque ratio of the hydraulic torque converter for coasting. tr=T_out/T_in where T is torque

Name

Type

Units

Vehicle Type

Description

cvt_eff_mapX

matrix

–

all

efficiency map for pulley ratio #X, (X goes from 1 to 5 currently) indexed by cvt_map_spd and cvt_map_trq

cvt_inertia

scalar

kg*m^2

all

rotational inertia of CVT, measured at input shaft

cvt_map_spd

vector

rad/s

all

range of CVT INPUT speeds

cvt_map_trq

vector

N*m

all

range of CVT INPUT torques

cvt_ratio

vector

–

all

range of pulley ratios

cvt_spd_scale

scalar

–

all

compresses or stretches (values1) speed range for map

cvt_trq_scale

scalar

–

all

compresses or stretches (values1) torque range for map

Name

Type

Units

Vehicle Type

Description

vc_clutch_bool

Boolean

–

conv

1 = engine is clutched out to avoid compression braking, 0= compression braking is allowed

vc_idle_bool

Boolean

–

conv

1 = engine idles, 0= engine turns off when it would otherwise idle

vc_idle_spd

scalar

rad/s

conv/ser

idle speed of the engine

vc_key_on

matrix

s, –

all

time in first column and corresponding key position in second column, 0=key off, 1=key on

vc_launch_spd

scalar

rad/s

conv

clutch input speed during clutch slip at vehicle launch

Name

Type

Units

Vehicle Type

Description

veh_proprietary

Boolean

–

all

0= public data, 1= restricted access

veh_description

char

–

all

text string description of the vehicle

veh_validation

char

–

all

0= no validation, 1= confirmed agreement with source data, 2= agrees with source data, and source data collection methods have been verified

veh_version

char

–

all

ADVISOR version number for which data file was created

veh_1st_rrc

scalar

–

all

1st coefficient of rolling resistance (no longer used as of version 2002)

veh_2nd_rrc

scalar

s/m

all

2nd coefficient of rolling resistance (no longer used as of version 2002)

veh_CD

scalar

–

all

coefficient of aerodynamic drag

veh_FA

scalar

m^2

all

vehicle frontal area

veh_cg_height

scalar

m

all

height of the vehicle center of gravity

veh_front_wt_frac

scalar

–

all

fraction of total vehicle mass supported by front axle when vehicle is not moving

veh_wheelbase

scalar

m

all

distance between front and rear axle

veh_glider_mass

scalar

kg

all

mass of the vehicle without components

veh_mass

scalar

kg

all

test mass, including fluids, passengers, and cargo

veh_cargo_mass

scalar

kg

all

cargo mass

Name

Type

Units

Vehicle Type

Description

wh_description

char

–

all

text string description of the wheels

wh_proprietary

Boolean

–

all

0= public data, 1= restricted access

wh_validation

char

–

all

0= no validation, 1= confirmed agreement with source data, 2= agrees with source data, and source data collection methods have been verified

wh_version

char

–

all

ADVISOR version number for which data file was created

wh_axle_loss_mass

vector

kg

all

vehicle test mass, used to index wh_axle_loss_trq

wh_axle_loss_trq

vector

N*m

all

front brake and axle bearing drag torque

wh_fa_dl_brake_frac

vector

–

all

fraction of braking done by driveline via front axle

wh_fa_dl_brake_mph

vector

mph

all

vehicle speed, used to index wh_fa_dl_brake_frac

wh_fa_fric_brake_frac

vector

–

all

fraction of braking done by front axle friction brakes

wh_fa_fric_brake_mph

vector

mph

all

vehicle speed, used to index wh_fa_fric_brake_frac

wh_inertia

scalar

kg*m^2

all

rotational inertia of the wheels

wh_mass

scalar

kg

all

total mass of all wheels 

wh_radius

scalar

m

all

radius of the wheel

wh_slip

vector

–

all

wheel slip of drive wheels

wh_slip_force_coeff

vector

–

all

(tractive force on front tires)/(vehicle weight on front tires), used to index wh_slip

wh_1st_rrc

scalar

–

all

1st coefficient of rolling resistance such that force of rolling resistance is (wh_1st_rrc+v*wh_2nd_rrc)*M*g*cos(theta) [where Mgcos(theta) is the weight normal over the axle

wh_2nd_rrc

scalar

s/m

2nd coefficient of rolling resistance

Name

Type

Units

Vehicle Type

Description

acc_description

char

–

all

text string description of the accessories

acc_proprietary

Boolean

–

all

0= public data, 1= restricted access

acc_validation

char

–

all

0= no validation, 1= confirmed agreement with source data, 2= agrees with source data, and source data collection methods have been verified

acc_version

char

–

all

ADVISOR version number for which data file was created

acc_mech_pwr

scalar

W

all

accessories mechanical load

acc_elec_pwr

scalar

W

all

accessories electrical load

Name

Type

Units

Vehicle Type

Description

ex_description

char

–

all

text string description of the exhaust system

ex_proprietary

Boolean

–

all

0= public data, 1= restricted access

ex_validation

char

–

all

0= no validation, 1= confirmed agreement with source data, 2= agrees with source data, and source data collection methods have been verified

ex_version

char

–

all

ADVISOR version number for which data file was created

ex_calc

boolean

–

all

=0= skip ex sys calc (if fc has no emis maps or no cat info available)  1= perform ex sys calcs including tailpipe emis

ex_cat_tmp_range

vector

C

all

cat temperature range used with frac vectors

ex_cat_hc_frac

matrix

–

all

catalyst HC conversion efficiency indexed by ex_cat_temp_range

ex_cat_co_frac

matrix

–

all

catalyst CO conversion efficiency indexed by ex_cat_temp_range

ex_cat_nox_frac

matrix

–

all

catalyst NOx conversion efficiency indexed by ex_cat_temp_range

ex_cat_pm_frac

matrix

–

all

catalyst PM conversion efficiency indexed by ex_cat_temp_range

ex_cat_lim

matrix

g/s

all

“break-thru” limit of converter (HC, CO, NOx, PM), max g/s for each pollutant

ex_cat_mon_mass

scalar

kg

all

mass of catalyst monolith (ceramic)

ex_cat_int_mass

scalar

kg

all

mass of catalyst internal SS shell

ex_cat_pipe_mass

scalar

kg

all

mass of catalyst inlet/outlet pipes

ex_cat_ext_mass

scalar

kg

all

mass of cat ext shell (shield)

ex_manif_mass

scalar

kg

all

mass of engine manifold & downpipe

ex_cat_pcm_mass

scalar

kg

all

mass of cat phase change mat’l heat storage

ex_muf_mass

scalar

kg

all

mass of muffler and other pipes downstream of cat

ex_mass

scalar

kg

all

total mass of the exhaust system

ex_cat_mass

scalar

kg

all

mass of catalytic converter

ex_cat_mon_cp

scalar

J/kg/K

all

average cp of catalyst monolith

ex_cat_int_cp

scalar

J/kg/K

all

average cp of catalyst internal SS shell

ex_cat_pipe_cp

scalar

J/kg/K

all

average cp of catalyst i/o pipes

ex_cat_ext_cp

scalar

J/kg/K

all

average cp of catalyst ext

ex_manif_cp

scalar

J/kg/K

all

average cp of manifold & dwnpipe

ex_gas_cp

scalar

J/kg/K

all

average cp of exh gas

ex_cat_pcm_tmp

matrix

C

all

temp range for cat pcm ecp vec

ex_cat_pcm_ecp

matrix

J/kg/K

all

ave eff heat cap of pcm (latent + sens)

ex_cat_mon_sarea

scalar

m^2

all

outer surface area of cat monolith

ex_cat_monf_sarea

scalar

m^2

all

surface area of cat monolith front face

ex_cat_moni_sarea

scalar

m^2

all

inner (honeycomb) surf area of cat monolith

ex_cat_int_sarea

scalar

m^2

all

surface area of cat interior

ex_cat_pipe_sarea

scalar

m^2

all

surface area of cat i/o pipes

ex_cat_ext_sarea

scalar

m^2

all

surface area of cat ext shield

ex_man2cat_length

scalar

m

all

length of exhaust pipe between manifold and cat conv

ex_manif_sarea

scalar

m^2

all

surface area of manif & downpipe: pi*D*L

ex_cat_m2p_emisv

scalar

–

all

emissivity x view factor from cat monolith to cat pipes

ex_cat_i2x_emisv

scalar

–

all

emissivity from cat int to cat ext shield

ex_cat_pipe_emisv

scalar

–

all

emissivity of cat i/o pipe

ex_cat_ext_emisv

scalar

–

all

emissivity of cat ext shield

ex_manif_emisv

scalar

–

all

emissivity of manif & dwnpipe

ex_cat_m2i_th_cond

matrix

W/K

all

cond btwn CERAMIC mono & int

ex_cat_m2i_tmp

matrix

C

all

corresponding temperature vector

ex_cat_i2x_th_cond

scalar

W/K

all

conductance btwn cat int & ext

ex_cat_i2p_th_cond

scalar

W/K

all

conductance btwn cat int & pipe

ex_cat_p2x_th_cond 

scalar

W/K

all

conductance btwn cat pipe & ext

ex_cat_max_tmp

scalar

C

all

maximum catalyst temperature(only used in old calc method)

ex_cat_mon_init_tmp

scalar

C

all

INIT CONDITION:monolith converter temp

ex_cat_int_init_tmp

scalar

C

all

INIT CONDITION:internal converter temp

ex_cat_pipe_init_tmp

scalar

C

all

INIT CONDITION:in/out converter pipe temp

ex_cat_ext_init_tmp

scalar

C

all

INIT CONDITION:external converter temp

ex_manif_init_tmp

scalar

C

all

INIT CONDITION:manifold temp

ex_cat_mat_th_res

scalar

m*m*K/W

all

x/k th res of mat or extra sleeve (NO MAT w/METAL MONO) or expanding paper mat (SAE#880282)

ex_cat_mon_th_res

scalar

m*m*K/W

all with close coupled converters

x/k th res of outer row of monolith cells

ex_cat_pcm_cp

scalar

J/kg/K

all with vacuum insulated converters

sens heat cap of cat pcm (LiNO3)

ex_cat_pcm_lh

scalar

J/kg

all with vacuum insulated converters

latent heat of cat pcm

ex_cat_pcm_mp

scalar

C

all with vacuum insulated converters

melting point of cat pcm

ex_scale

scalar

–

all

scaling factor for the exhaust system

Name

Type

Units

Vehicle Type

Description

filename

char

–

all

name of the block diagram to be used

veh_gravity

scalar

m/s^2

all

gravitational acceleration

amb_temp

scalar

C

all

ambient temperature

veh_air_density

scalar

kg/m^3

all

density of air

pwr_index

scalar

–

–

an index variable in a FOR loop in some of the PTC_*.m files. This variable should not appear on the workspace in future versions of ADVISOR.

air_cp

scalar

J/kg/K

–

specific heat of air

deltaSOC_tol

scalar

–

–

tolerance for zero delta SOC correction, given by user in the GUI

ic_description

char

–

–

description of initial conditions, e.g., ‘Standard initial conditions’ or ‘Hot-Start initial conditions’

max_zero_delta_iter

scalar

–

–

maximum number of zero delta SOC iterations

Name

Type

Units

Vehicle Type

Description

gc_description

char

–

ser

text string description of the generator

gc_proprietary

Boolean

–

ser

0= public data, 1= restricted access

gc_validation

char

–

ser

0= no validation, 1= confirmed agreement with source data, 2= agrees with source data, and source data collection methods have been verified

gc_version

char

–

ser

ADVISOR version number for which data file was created

gc_map_spd

vector

rad/s

ser

speed range of the generator

gc_map_trq

vector

N*m

ser

torque range of the generator

gc_eff_map

matrix

–

ser

generator efficiency map indexed by gc_map_spd and gc_map_trq

gc_inertia

scalar

kg*m^2

ser

rotational inertia of the generator

gc_mass

scalar

kg

ser

mass of the generator

gc_max_crrnt

scalar

A

ser

max. current allowed in generator/controller

gc_max_trq

vector

N*m

ser

maximum torque output of the generator indexed by gc_map_spd

gc_min_volts

scalar

V

ser

min. voltage allowed in generator/controller

gc_outpwr_map

matrix

W

ser

electric output power map, indexed by gc_map_spd and gc_map_trq

gc_overtrq_factor

scalar

–

ser

factor by which absorbed input torque can exceed max continuous for short periods

gc_spd_scale

scalar

–

ser

speed scaling factor

gc_trq_scale

scalar

–

ser

torque scaling factor

gc_cp

scalar

J/kg/K

prius_jpn

used in the prius_jpn thermal model. Average heat capacity of motor/controller (estimate: ave of SS & Cu)

gc_eff_scale

scalar

–

prius_jpn

generator/controller efficiency scaling. This variable is not used directly in modelling and should always be equal to one–it’s used for initialization purposes

gc_inpwr_map

scalar

W

prius_jpn

used in the prius_jpn block diagram generator controller model. The input power for each torque and speed for the generator/controller

gc_sarea

scalar

m^2

prius_jpn

the surface area of the generator/controller. used in the prius_jpn block diagram (lib_electric_machine/Prius gen/ controller <gc>)

gc_th_calc

Boolean

–

prius_jpn

a flag. 0=no mc thermal calculations, 1=do calc’s

gc_tstat

scalar

C

prius_jpn

thermostat temp of motor/controler when cooling pump comes on

Name

Type

Units

Vehicle Type

Description

tc_description

char

–

par

text string description of the torque coupler

tc_proprietary

Boolean

–

par

0= public data, 1= restricted access

tc_validation

char

–

par

0= no validation, 1= confirmed agreement with source data, 2= agrees with source data, and source data collection methods have been verified

tc_version

char

–

par

ADVISOR version number for which data file was created

tc_loss

scalar

N*m

par

loss parameter

tc_mc_to_fc_ratio

scalar

–

par

constant ratio of speed at motor torque input to speed at engine torque input

Name

Type

Units

Vehicle Type

Description

mc_description

char

–

par/ser

text string description of the motor/controller

mc_proprietary

Boolean

–

par/ser

0= public data, 1= restricted access

mc_validation

char

–

par/ser

0= no validation, 1= confirmed agreement with source data, 2= agrees with source data, and source data collection methods have been verified

mc_version

char

–

par/ser

ADVISOR version number for which data file was created

mc_map_spd

vector

rad/s

par/ser

speed range of the motor

mc_map_trq

vector

N*m

par/ser

torque range of the motor

mc_eff_map

matrix

–

par/ser

efficiency map of the motor indexed by mc_map_spd and mc_map_trq

mc_inertia

scalar

kg*m^2

par/ser

rotational inertia of the motor

mc_inpwr_map

matrix

W

par/ser

input power map, indexed by mot_map_spd and mot_map_trq

mc_mass

scalar

kg

par/ser

mass of the motor/controller

mc_max_crrnt

scalar

A

par/ser

max. current allowed in motor/controller

mc_max_trq

vector

N*m

par/ser

maximum torque curve of the motor indexed by mc_map_spd

mc_min_volts

scalar

V

par/ser

min. voltage allowed in motor/controller

mc_overtrq_factor

scalar

–

par/ser

factor by which output torque can exceed max continuous for short periods

mc_spd_scale

scalar

–

par/ser

speed scaling factor

mc_trq_scale

scalar

–

par/ser

torque scaling factor

mc_th_calc

Boolean

–

all

0=no mc thermal calculations, 1=do calc’s

mc_cp

scalar

J/kg/K

all

ave heat capacity of motor/controller 

mc_tstat

Scalar

C

all

thermostat temp of motor/controller when cooling pump comes on

mc_sarea

scalar

m^2

all

total module surface area exposed to cooling fluid

mc_area_scale

scalar

–

par/ser

area scaling factor for the motor/controller

mc_eff_scale

scalar

–

par/ser

not used directly in modeling, this variable should always be equal to one as it is used for initialization purposes

mc_max_cont_trq

vector

N*m

par/ser

maximum continuous torque curve of the motor indexed by mc_map_spd

mc_outpwr_map

matrix

W

par/ser

used to compute mc_inpwr_map as mc_inpower_map = mc_outpwr_map + mc_losspwr_map

mc_init_tmp

scalar

C

par/ser

initial temperature of the motor/controller

Name

Type

Units

Vehicle Type

Description

cs_charge_trq

scalar

N*m

par

hybrid_chargetrq*(SOCinit-SOC) = an alternator-like torque loading on the engine to recharge the battery pack; negative recharge is never requested

cs_electric_launch_spd

scalar

m/s

par

vehicle speed threshold; below this speed, the fuel converter is turned off

cs_min_trq_frac

scalar

–

par

cs_min_trq_frac*(torque capability of engine at current speed) = minimum torque threshold; when commanded at a lower torque, the engine will operate at the threshold torque and the motor acts as a generator

cs_off_trq_frac

scalar

–

par

cs_off_trq_frac*(torque capability of engine at current speed) = minimum torque threshold; when commanded at a lower torque, the engine will SHUT OFF

cs_fc_init_state

scalar

Boolean

ser

1=fuel converter (FC) is initially on; 0=FC initially off

cs_charge_pwr

scalar

W

ser

cs_charge_pwr*fc_spd_scale*fc_trq_scale*((cs_soc_hi+ cs_soc_lo)/2-SOC) is the SOC-stabilizing adjustment made to the bus power requirement

cs_max_pwr

scalar

W

ser

cs_max_pwr*fc_spd_scale*fc_trq_scale is the maximum power commanded of the fuel converter unless SOC<cs_lo_soc

cs_min_pwr

scalar

W

ser

cs_min_pwr*fc_spd_scale*fc_trq_scale is the minimum power commanded of the fuel converter

cs_max_pwr_fall_rate

scalar

W/s

ser

cs_max_pwr_fall_rate*fc_spd_scale*fc_trq_scale is the fastest the fuel converter power command can decrease (this number < 0)

cs_max_pwr_rise_rate

scalar

W/s

ser

cs_max_pw_rise_rate*fc_spd_scale*fc_trq_scale is the fastest the fuel converter power command can increase

cs_min_off_time

scalar

s

ser

the shortest allowed duration of a FC-off period; after this time has passed, the FC may restart if high enough powers are required by the bus

cs_pwr

vector

W

ser

cs_pwr*fc_spd_scale*fc_trq_scale is the vector of FC powers that define the locus of best efficiency points throughout the genset map

cs_spd

vector

rad/s

ser

cs_spd*fc_spd_scale is the vector of FC speeds in locus of best efficiency points, indexed by cs_pwr*fc_spd_scale*fc_trq_scale

cs_hi_soc

scalar

–

par/ser

highest state of charge allowed

cs_lo_soc

scalar

–

par/ser

lowest state of charge allowed

cs_fc_spd_opt

vector

rad/s

prius_jpn

optimum speed points for fc operation used along with cs_fc_trq_opt and cs_fc_pwr_opt

cs_fc_trq_opt

vector

N*m

prius_jpn

optimum torque points for fc operation used along with cs_fc_spd_opt and cs_fc_pwr_opt

cs_fc_pwr_opt

vector

Watts

prius_jpn

power values for which cs_fc_trq_opt and cs_fc_spd_opt are defined.

cs_charge_deplete_bool

boolean

–

par/ser

1=> use charge deplete strategy, 0=> use charge sustaining strategy

cs_fc_max_pwr_frac

scalar

–

par with CVT

engine power fraction below which engine would like to operate

cs_fc_min_pwr_frac

scalar

–

par with CVT

engine power fraction above which engine would like to operate

cs_hi_trq_frac

scalar

–

load/ SOC balanced par

highest desired engine load fraction

cs_lo_trq_frac

scalar

–

load/ SOC balanced par

lowest desired engine load fraction

cs_offset_soc

scalar

–

par

x-intercept of electric launch speed vs. SOC - ONLY active if cs_charge_deplete_bool=1

cs_trq_to_soc_factor

scalar

–

load/ SOC balanced par

weighting factor for the relative importance of engine operation near the goal to the SOC operation near the goal ==> low values mean that SOC is more important, large values mean engine is more important

cs_tstat_init_state

scalar

–

EV

used in EV PTC, initial FC state; 1=> on, 0=> off

Name

Type

Units

Vehicle Type

Description

sim_stop_distance

scalar

m

all

used in the <vc> block (see lib_controls.mdl), when enable_sim_stop_distance is non-zero, to stop the simulation after a desired distance has been traversed. Used in control logic for events such as acceleration test.

sim_stop_speed

scalar

mi/hr

all

used in the <vc> block when enable_sim_stop_speed is non-zero to stop the simulation if a desired speed is exceeded. Used in control logic for events such as the acceleration test.

sim_stop_time

scalar

s

all

used in the <vc> block when enable_sim_stop_time is non-zero to stop the simulation when sim_stop_time has elapsed. Used in control logic for events such as the acceleration test.

enable_sim_stop_distance

Boolean

–

all

GUI/simulation related variable used with the acceleration test. See <vc> /sim stop sub-system in the block diagrams.

enable_sim_stop_speed

Boolean

–

all

GUI/simulation related variable used with the acceleration test. See <vc> /sim stop sub-system in the block diagrams.

enable_sim_stop_time

Boolean

–

all

GUI/simulation related variable used with the acceleration test. See <vc> /sim stop sub-system in the block diagrams. 

enable_speed_scope

Boolean

–

all

GUI/simulation related variable used with the J1711 test

enable_stop_fc

Boolean

–

all

if set to 1, then the simulation will end when the engine (fc) is turned on. Else, if set to 0, the simulation will run regardless of whether the engine is on or not.

fc_on

Boolean

–

all

simulation control parameter; 1 = fuel converter on, 0 = fuel converter off. If =0, run in EV mode with J1711 test

enable_stop

Boolean

–

vehicles with ess

if enabled, used by J1711 test procedure to stop simulation when SOC=0

ess_on

Boolean

–

vehicles with ess

Boolean simulation parameter used to show if the batteries are enabled (=1) or disabled (=0). Used by J1711 test procedure for conventional mode

Name

Type

Units

Vehicle Type

Description

acc_elec_eff

scalar

–

all

the efficiency of the electrical accesories

acc_elec_pwr_in_a

vector

W

all

the achieved electrical power input to accesories

acc_elec_pwr_out_a

vector

W

all

the achieved electrical power out from accesories

acc_mech_eff

scalar

–

all

the efficiency of the accessory (mechanical)

acc_mech_pwr_in_a

vector

W

all

the achieved mechanical power input to the mechanical accesories for each time step of the drive cycle

acc_mech_pwr_out_a

vector

W

all

the achieved useful mechanical power output from the mechanical accesories for each time step of the drive cycle

acc_mech_trq

scalar

N*m

all

constant torque load on engine

Name

Type

Units

Vehicle Type

Description

cyc_mph_r

vector

mph

all

requested vehicle speed

cyc_kph_r

vector

kph

all

requested vehicle speed in units of kilometer per hour

t

vector

s

all

time vector defining the drive cycle

lim_key_off

vector

–

all

time vector for key off; 0=key on 1=key off

elevation

vector

m

all

time vector containing vehicle elevation above sea level

grade

vector

decimal

all

time vector of the grade of the road during the simulation in decimal(ex. 0.02 is a 2% grade)

veh_cargo_mass_vs_time

vector

kg

all

time vector of the added (subtracted) mass of the vehicle vs. time–available to plot in post-processing

distance

vector

m

all

time vector containing the distance the vehicle has traveled

Name

Type

Units

Vehicle Type

Description

ess_pwr_out_a

vector

W

par/ser

power out of ess available

ess_pwr_out_r

vector

W

par/ser

power out of ess requested

ess_soc_hist

vector

–

par/ser

state of charge history

ess_current

vector

A

par/ser

current output of the battery

ess_mod_tmp

vector

C

all

ave temperature of battery module

ess_air_tmp

vector

C

all

ave temperature of battery cooling air

ess_air_th_pwr

vector

W

all

heat removed from battery by cooling air 

lim_ess_pwr

vector

–

par/ser

0= ess not power limited, 1= ess power limited

lim_ess_minV

vector

–

par/ser

0=ess not limited by minimum voltage, 1=ess min voltage limited

lim_ess_maxV

vector

–

par/ser

0=ess not limited by maximum voltage, 1=ess max voltage limited

dE_dt_stored

vector

W

vehicles with ess.

vector of the energy stored in the energy storage system by time step.

ess_pwr_loss_a

vector

W

par/ser

the actual power loss for the energy storage system

lim_ess_soc_hi

vector

–

vehicles with ess

the energy storage system state of charge upper limit (see block diagram in the <sdo> block)

lim_ess_soc_low

vector

–

vehicles with ess

the energy storage system state of charge upper limit (see block diagram in the <sdo> block)

ess_eff

scalar

–

vehicles with ess

round-trip efficiency

ess_in_kj

scalar

kJ

vehicles with ess

total energy into energy storage system over the drive cycle

ess_loss_kj

scalar

kJ

vehicles with ess

total energy into the energy storage system not stored or used as output over the drive cycle

ess_out_kj

scalar

kJ

vehicles with ess

useful energy leaving the batteries over the drive cycle

ess_stored_kj

scalar

kJ

vehicles with ess

energy stored in the energy storage system over the drive cycle

ess_out_kj

scalar

kJ

vehicles with ess

useful energy leaving the batteries over the drive cycle

ess_stored_kj

scalar

kJ

vehicles with ess

the difference between the energy into storage and the useful energy out of storage

eta_ess_chg

scalar

kJ

vehicles with ess

recharge efficiency

eta_ess_dis

scalar

kJ

vehicles with ess

discharge efficiency

into_storage_kj

scalar

kJ

vehicles with ess

useful energy coming into the batteries over the drive cycle.

out_of_storage_kj

scalar

kJ

vehicles with ess

energy leaving the batteries when power is flowing out (useful out+losses out)

Name

Type

Units

Vehicle Type

Description

gc_pwr_out_a

vector

W

ser

available power out of generator

gc_spd_in_a

vector

rad/s

ser

available speed into the generator

gc_trq_in_a

vector

rad/s

ser

available torque into the generator

genset_min_pwr

scalar

W

ser

the minimum power of the generator/controller set

gc_eff

scalar

–

all with gc

the efficiency of the generator/controller

gc_in_kj

scalar

kJ

all with gc

total energy into the generator/controller over the drive cycle

gc_loss_kj

scalar

kJ

all with gc

the loss of the generator/controller over the drive cycle

gc_out_kj

scalar

kJ

all with gc

the total energy output of the generator/controller over the drive cycle

Name

Type

Units

Vehicle Type

Description

lim_mc_crrnt

vector

amps

par/ser

0= motor/controller not current limited, 1= motor/controller current limited

lim_mc_spd

vector

rad/s

par/ser

0= motor/controller not speed limited, 1= motor/controller current limited

lim_mc_trq

vector

N*m

par/ser

0= motor/controller not torque limited, 1= motor/controller current limited

lim_mc_voltage

vector

volts

par/ser

0= motor/controller not voltage limited, 1= motor/controller current limited

mc_pwr_in_a

vector

W

par/ser

available power into the motor

mc_pwr_in_r

vector

W

par/ser

power requested from the motor

mc_spd_out_a

vector

rad/s

par/ser

available speed out of the motor

mc_spd_out_r

vector

rad/s

par/ser

requested speed out of the motor

mc_trq_out_a

vector

N*m

par/ser

available torque out of the motor

mc_trq_out_r

vector

N*m

par/ser

requested torque out of the motor

mc_tmp

vector

C

all

ave temperature of motor and controller

mc_clt_th_pwr

vector

W

all

heat removed from motor/ctrl by coolant

mc_max_trq_vec

vector

N*m

par/ser

vector of maximum torques. See motor/controller block diagram <mc>, motor/controller <mc> par, and motor/controller <mc> prius, under ‘enforce torque limit’ sub-block for details of use.

mc_ni_trq_out_a

vector

N*m

par/ser

rotor drive torque available (see motor controller block diagram)

mc_pwr_loss

vector

W

par/ser

power lost by the motor/controller

mc_spd_est

vector

rad/s

par/ser

motor’s rotor speed during previous time step

mc_eff

scalar

–

all with mc

the efficiency of the motor/controller

mc_in_kj

scalar

kJ

all with mc

the total energy into the motor during a drive cycle

mc_loss_kj

scalar

kJ

all with mc

the difference between the total energy into and the total useful energy out of the motor/controller during a drive cycle.

mc_out_kj

scalar

kJ

all with mc

the total useful energy out of the motor/controller during a drive cycle

mot_as_gen_eff

scalar

kJ

all with mc

motor efficiency when acting as a generator