A.1 Variable naming convention
A.2 ADVISOR Input Variables
A.3 ADVISOR Output Variables
B. ADVISOR’s data files
C. Commonly used Matlab commands
D. Conventions for Goto tag use
E. Glossary
ADVISOR variable names use only lowercase letters.
All ADVISOR variables use prefixes except the three main output variables: emistailpipe emissions, galtotal fuel use, and mphathe actual vehicle speed. The other input and output variables use the same prefixes used for the component data file names, which are also enclosed in ‘<’ in the appropriate Simulink block on the main level of ADVISOR’s block diagrams.
cs_*  Hybrid control strategy variables 
cvt_*  Continuously variable transmission variables 
cyc_*  Driving cycle variables 
ess_*  Energy storage system variables 
fc_*  Fuel converter variables 
fd_*  Final drive variables 
gb_*  Gearbox variables 
gc_*  Generator/controller variables 
mc_*  Motor/controller variables 
tx_*  Transmission variables 
vc_*  Vehicle control variables (engine and clutch) 
veh_*  Vehicle (coastdownrelated) variables 
ADVISOR variable names with prefixes always use the word indicating the units or value of the variable last. For example, the initial stateofcharge of the energy storage system is stored in the variable ess_init_soc.
Drive Cycle (Input Variables) 

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 Ah 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 opencircuit 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 
crosssec 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 Ah 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 spiralwound 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 opencircuit 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 
crosssec 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 
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 
engineout 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] 
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== GCToolbased 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 
Powertrain Control (Input Variables) 

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 
Transmission (Input Variables) 

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=> nonproprietary, 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 
[m/s, 
all except 
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 stepfunction (e.g., [0 1; 10 1; 10 2; 20 2]) 
tx_spd_dep_dnshift 
2d matrix 
[m/s, 
all except 
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 stepfunction (e.g., [0 1; 10 1; 10 2; 20 2]) 
tx_speed_dep 
Boolean 
– 
all except 
a flag which indicates if speeddependent 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 nonCVT 
a vector of loads (0 to 1) for downshifting commands (see lib_controls block diagram). (the first element is for 1st gear, etc.) 
gb_dnshift_spd 
vector 
rad/s 
all nonCVT 
a vector of speeds (rad/s) for downshifting commands (see lib_controls block diagram). (the first element is for 1st gear, etc.) 
gb_upshift_load 
vector 
– 
all nonCVT 
a vector of loads (0 to 1) for upshifting commands (see lib_controls block diagram). (the first element is for 1st gear, etc.) 
gb_upshift_spd 
vector 
rad/s 
all nonCVT 
a vector of speeds (rad/s) for upshifting 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 
Equation (1): P_loss = (gb_loss_input_spd_coeff * gear_ratio + gb_loss_output_spd_coeff)*output_shaft_speed + (gb_loss_input_trq_coeff / gear_ratio + gb_loss_output_trq_coeff) * output_shaft_torque + gb_loss_output_pwr_coeff * output_shaft_power + gb_loss_const


Name 
Type 
Units 
Vehicle Type 
Description 
htc_k 
vector 
rad/s/(N*m)^0.5 
conv 
torque converter’s Kfactor 
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 autotransmission 
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 autotransmission 
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 autotransmission 
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*ms^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 autotransmission 
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 
AccessoriesRelated (Input Variables) 

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 
Exhaust System (& Catalyst) Variables (Input Variables) 

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 
“breakthru” 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 
Miscellaneous (Input Variables) 

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 ‘HotStart 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*(SOCinitSOC) = an alternatorlike 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)/2SOC) is the SOCstabilizing 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 FCoff 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 
xintercept 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 
Simulation Control Variables (Input Variables) 

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 nonzero, 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 nonzero 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 nonzero 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 subsystem in the block diagrams. 
enable_sim_stop_speed 
Boolean 
– 
all 
GUI/simulation related variable used with the acceleration test. See <vc> /sim stop subsystem in the block diagrams. 
enable_sim_stop_time 
Boolean 
– 
all 
GUI/simulation related variable used with the acceleration test. See <vc> /sim stop subsystem 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 
Accessories (Output Variables) 

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 
Drive Cycle (Output Variables) 

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 postprocessing 
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 
roundtrip 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’ subblock 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 
mot_as_gen_in_kj 
scalar 
kJ 
all with mc 
input to the motor as a generator 
mot_as_gen_loss_kj 
scalar 
kJ 
all with mc 
difference between the input and the useful output of the motor as a generator 
mot_as_gen_out_kj 
scalar 
kJ 
all with mc 
the useful output of the motor as a generator 
Power Bus (Output Variables) 

Name 
Type 
Units 
Vehicle Type 
Description 
pb_pwr_out_a 
vector 
W 
par/ser 
available power out of the power bus 
pb_pwr_out_r 
vector 
W 
par/ser 
requested power out of the power bus 
pb_voltage 
vector 
volts 
par/ser 
voltage of the power bus 


Name 
Type 
Units 
Vehicle Type 
Description 
tc_spd_out_a 
vector 
rad/s 
par 
available speed out of the torque coupler 
tc_spd_out_r 
vector 
rad/s 
par 
requested speed out of the torque coupler 
tc_trq_out_a 
vector 
N*m 
par 
available torque out of the torque coupler 
tc_trq_out_r 
vector 
N*m 
par 
requested torque out of the torque coupler 
tc_pwr_in_a 
vector 
N*m/s 
par 
available power into the torque coupler 
tc_eff 
scalar 
– 
par 
the efficiency of the torque coupler over the drive cycle 
tc_in_kj 
scalar 
kJ 
par 
the total energy into the torque coupler over the drive cycle 
tc_in_regen_kj 
scalar 
kJ 
par 
the total energy into the torque coupler during regenerative breaking events for the drive cycle 
tc_loss_kj 
scalar 
kJ 
par 
the difference between the total power into the torque coupler and the total useful power out of the torque coupler 
tc_out_kj 
scalar 
kJ 
par 
the total useful energy output of the torque coupler over the drive cycle 
tc_out_regen_kj 
scalar 
kJ 
par 
the total useful energy output of the torque coupler over the drive cycle that is associated with regenerative breaking 
tc_regen_eff 
scalar 
– 
par 
the efficiency of the torque coupler with regard to transmitting energy for regenerative breaking 
tc_regen_loss_kj 
scalar 
kJ 
par 
the cumulative energy lost over the drive cycle during regenerative breaking events 


Name 
Type 
Units 
Vehicle Type 
Description 
emis 
matrix 
g/s 
all 
tailpipe out HC, CO, NOx and PM emissions 
emis_old 
matrix 
g/s 
all 
tailpipe HC, CO, NOx, and PM emissions using old method (catalyst temperature dependent on time only) 
emis_ppm 
matrix 
ppm 
all 
emissions in partspermillion (1=HC, 2=CO, 3=NOx, 4=PM) 
gal 
vector 
gal 
all 
cumulative gallons of fuel consumed 
liters 
vector 
liters 
all 
cumulative liters of fuel consumed 
mpha 
vector 
mi/hr 
all 
achieved vehicle speed 
kpha 
vector 
kilometer/hr 
all 
achieved vehicle speed (kph) 
veh_force_a 
vector 
N 
all 
force achieved by the vehicle 
veh_force_r 
vector 
N 
all 
force requested by the vehicle 
veh_spd_a 
vector 
m/s 
all 
speed achieved by the vehicle 
veh_spd_r 
vector 
m/s 
all 
speed requested by the vehicle 
ar1 
vector 
m/s^2 
all 
vehicle acceleration rate requested 
lim_key_off 
scalar 
boolean 
all 
specifies if ignition key is off (1=off, 0=on) 
aero_kj 
scalar 
kJ 
all 
loss due to aerodynamic drag on the vehicle in kilojoules 


Name 
Type 
Units 
Vehicle Type 
Description 
lim_wh_brake 
vector 
– 
all 
wheel brake limited Boolean: 1= wheel brakes were force limited, 0= wheel brakes were not force limited 
wh_spd_a 
vector 
rad/s 
all 
wheel speed achieved 
wh_spd_r 
vector 
rad/s 
all 
wheel speed requested 
lim_wh_traction 
vector 
– 
all 
wheel traction limited Boolean: 1= wheel was slip limited, 0= wheel was not slip limited 
wh_trq_a 
vector 
N*m 
all 
wheel torque achieved 
wh_trq_r 
vector 
N*m 
all 
wheel torque requested 
wh_slip_r 
vector 
rad 
all 
amount of slip requested at wheels 
wh_brake_loss_pwr 
vector 
N*m/s 
all 
amount of power loss from braking 
wh_eff 
scalar 
– 
all 
the efficiency of the wheel during the drive cycle 
wh_in_kj 
scalar 
kJ 
all 
the total energy transmitted in through the wheel (from the power train) during the drive cycle 
wh_in_regen_kj 
scalar 
kJ 
all 
the total energy transmitted in through the wheel for purposes of regenerative breaking 
wh_loss_kj 
scalar 
kJ 
all 
the difference between the total energy into the wheel and the useful energy transmitted by the wheel over the drive cycle 
wh_out_kj 
scalar 
kJ 
all 
the useful energy output of the wheel during the drive cycle–used to maintain the achieved force and speed 
wh_out_regen_kj 
scalar 
kJ 
all 
the useful energy transmitted up the drive train by the wheel for regeneration during the drive cycle 
wh_regen_eff 
scalar 
kJ 
all 
the efficiency of the wheel with respect to regeneration 
wh_regen_loss_kj 
scalar 
kJ 
all 
the difference between the total kinetic energy into the wheel and the useful energy transmitted up the drive train by the wheel for regenerative breaking over the drive cycle 
Final Drive Axle (Output Variables) 

Name 
Type 
Units 
Vehicle Type 
Description 
fd_spd_in_a 
vector 
rad/s 
all 
speed achieved into the final drive 
fd_spd_in_r 
vector 
rad/s 
all 
speed requested into the final drive 
fd_spd_out_a 
vector 
rad/s 
all 
speed achieved out of the final drive 
fd_spd_out_r 
vector 
rad/s 
all 
speed requested out of the final drive 
fd_trq_in_a 
vector 
N*m 
all 
torque achieved into the final drive 
fd_trq_in_r 
vector 
N*m 
all 
torque requested into the final drive 
fd_trq_out_a 
vector 
N*m 
all 
torque achieved out of the final drive 
fd_trq_out_r 
vector 
N*m 
all 
torque requested out of the final drive 
fd_eff 
scalar 
– 
all 
the average efficiency over the drive cycle for the final drive 
fd_in_kj 
scalar 
kJ 
all 
the total energy into the final drive over the drive cycle 
fd_in_regen_kj 
scalar 
kJ 
all 
the total energy into the final drive over the drive cycle for the purpose of regeneration 
fd_loss_kj 
scalar 
kJ 
all 
the total energy lost through the final drive during the drive cycle. Equal to the difference between the total energy into the final drive minus the useful energy output from the final drive 
fd_out_kj 
scalar 
kJ 
all 
the total useful energy output from the final drive during the drive cycle. 
fd_out_regen_kj 
scalar 
kJ 
all 
the total energy transmitted up the drive train by the final drive for purposes of regeneration. 
fd_regen_eff 
scalar 
kJ 
all 
the total energy transmitted up the drive train by the final drive for purposes of regeneration. 
fd_regen_loss_kj 
scalar 
kJ 
all 
the cumulative loss through the final drive during regeneration events in a drive cycle 


Name 
Type 
Units 
Vehicle Type 
Description 
gb_spd_in_a 
vector 
rad/s 
all 
speed achieved into the gearbox 
gb_spd_in_r 
vector 
rad/s 
all 
speed requested into the gearbox 
gb_spd_out_a 
vector 
rad/s 
all 
speed achieved out of the gearbox 
gb_spd_out_r 
vector 
rad/s 
all 
speed requested out of the gearbox 
gb_trq_in_a 
vector 
N*m 
all 
torque achieved into the gearbox 
gb_trq_in_r 
vector 
N*m 
all 
torque requested into the gearbox 
gb_trq_out_a 
vector 
N*m 
all 
torque achieved out of the gearbox 
gb_trq_out_r 
vector 
N*m 
all 
torque requested out of the gearbox 
gear_number 
vector 
– 
all 
current gear number 


Name 
Type 
Units 
Vehicle Type 
Description 
htc_spd_in_a 
vector 
rad/s 
conv 
speed achieved into the torque converter 
htc_spd_in_r 
vector 
rad/s 
conv 
speed requested into the torque converter 
htc_spd_out_a 
vector 
rad/s 
conv 
speed achieved out of the torque converter 
htc_spd_out_r 
vector 
rad/s 
conv 
speed requested out of the torque converter 
htc_trq_in_a 
vector 
N*m 
conv 
torque achieved into the torque converter 
htc_trq_in_r 
vector 
N*m 
conv 
torque requested into the torque converter 
htc_trq_out_a 
vector 
N*m 
conv 
torque achieved out of the torque converter 
htc_trq_out_r 
vector 
N*m 
conv 
torque requested out of the torque converter 
htc_eff 
scalar 
– 
conv 
the efficiency of the hydraulic torque converter 
htc_in_kj 
scalar 
kJ 
conv 
the total energy into the hydraulic tourque converter over the drive cycle 
htc_loss_kj 
scalar 
kJ 
conv 
the net loss through the hydraulic torque converter over the drive cycle in kJ 
htc_out_kj 
scalar 
kJ 
conv 
the total useful energy out of the hydraulic torque converter over the drive cycle 
htc_regen_eff 
scalar 
kJ 
conv 
the efficiency of the hydraulic torque converter with respect to regeneration 
htc_regen_in_kj 
scalar 
kJ 
conv 
the total energy into the hydraulic torque converter over the drive cycle that is to be used for regeneration purposes 
htc_regen_loss_kj 
scalar 
kJ 
conv 
the total loss of energy during the drive cycle associated with regeneration events 
htc_regen_out_kj 
scalar 
kJ 
conv 
the total useful energy output of the hydraulic torque converter for purpose of regeneration 


Name 
Type 
Units 
Vehicle Type 
Description 
cvt_spd_in_a 
vector 
rad/s 
all 
speed achieved into the CVT 
cvt_spd_in_r 
vector 
rad/s 
all 
speed requested into the CVT 
cvt_spd_out_a 
vector 
rad/s 
all 
speed achieved out of the CVT 
cvt_spd_out_r 
vector 
rad/s 
all 
speed requested out of the CVT 
cvt_trq_in_a 
vector 
N*m 
all 
torque achieved into the CVT 
cvt_trq_in_r 
vector 
N*m 
all 
torque requested into the CVT 
cvt_trq_out_a 
vector 
N*m 
all 
torque achieved out of the CVT 
cvt_trq_out_r 
vector 
N*m 
all 
torque requested out of the CVT 


Name 
Type 
Units 
Vehicle Type 
Description 
lim_clutch_dis 
vector 
– 
all 
clutch disengaged Boolean, 1= disengaged, 0= engaged or partially engaged 
clutch_state 
vector 
– 
all 
clutch state: 1= clutch disengaged, 2= clutch slipping, 3= clutch engaged 
shifting 
vector 
– 
all 
0= not shifting gears, 1= shifting gears 
clutch_eff 
scalar 
– 
all 
the efficiency of the clutch 
clutch_in_kj 
scalar 
kJ 
all 
the total energy into the clutch over a drive cycle 
clutch_loss_kj 
scalar 
kJ 
all 
the difference between the energy into the clutch and the energy out of the clutch in kJ over a drive cycle 
clutch_out_kj 
scalar 
kJ 
all 
the total energy out of the clutch in kJ over a drive cycle 
clutch_regen_eff 
scalar 
– 
all 
the efficiency of the clutch over the drive cycle with regard to regeneration 
clutch_regen_in_kj 
scalar 
kJ 
all 
the total energy over the drive cycle entering into the clutch for regeneration purposes 
clutch_regen_loss_kj 
scalar 
kJ 
all 
the difference between the energy into the clutch for regeneration purposes and the energy leaving the clutch for regeneration purposes 
clutch_regen_out_kj 
scalar 
kJ 
all 
the total energy over the drive cycle that leaves the clutch for regeneration purposes (kJ) 


Name 
Type 
Units 
Vehicle Type 
Description 
fc_spd_out_a 
vector 
rad/s 
all(~fuel cell) 
speed achieved by the engine 
fc_spd_out_r 
vector 
rad/s 
all(~fuel cell) 
speed requested of the engine 
fc_trq_ out_a 
vector 
N*m 
all(~fuel cell) 
torque output achieved by the engine 
lim_fc_trq 
vector 
– 
all(~fuel cell) 
engine torque limited Boolean, 1= engine was torque limited, 0= engine was not torque limited 
lim_fc_spd 
vector 
– 
all(~fuel cell) 
engine speed limited Boolean, 1= engine was torque limited, 0= engine was not torque limited 
fc_trq_ out_r 
vector 
N*m 
all(~fuel cell) 
torque output requested of the engine 
fc_inertia_trq 
vector 
N*m 
all(~fuel cell) 
inertial torque of the fuel converter 
lim_engine_off 
vector 
– 
all 
1= engine off, 0= engine on 
fc_brake_trq 
vector 
N*m 
all(~fuel cell) 
torque output requested of the engine 
fc_coolant_th_pwr 
vector 
W 
all 
thermal power (heat) from fc into coolant 
fc_emis_eo 
matrix 
g/s 
all 
engineout HC, CO, NOx, and PM emissions 
fc_ex_gas_flow 
vector 
g/s 
all 
exhaust gas mass flow rate 
fc_fuel_in_pwr 
vector 
W 
all 
fuel converter input (fuel) power 
fc_fuel_rate 
vector 
g/s 
all 
fuel converter fuel use in grams per second 
fc_mech_out_pwr 
vector 
W 
all 
fuel converter output (mechanical) power 
fc_th_pwr 
vector 
W 
all 
waste heat from combustion to engine mass 
fc_r_th_pwr 
vector 
W 
all 
heat removed from engine mass by radiator 
fc_h_th_pwr 
vector 
W 
all 
heat extracted from engine coolant for cabin heating 
fc_pwr_out_a 
vector 
W 
fuel cell 
electrical power out of the fuel cell system achieved 
fc_pwr_out_r 
vector 
W 
fuel cell 
electrical power out of the fuel cell system requested 
fc_spd_est 
vector 
rad/s 
all 
the estimated angular speed of the fuel converter (see block diagrams) 
fc_tmp 
matrix (n x 4) 
C 
all 
fuel converter temperatures with time. Temperatures are: cylinder temperature, engine interior temperature (block), engine exterior temperature (engine accessories), and hood temperature. 
fc_eff_avg 
scalar 
– 
all 
the average efficiency of the fuel converter over the drive cycle 
fc_ex_gas_tmp 
vector 
C 
all 
the temperature of the exhaust gasses out of the fuel converter over the drive cycle 
fc_ex_th_pwr 
vector 
W 
all 
exhaust heat expelled during the drive cycle 
fc_loss_kj 
scalar 
kJ 
all 
the difference between the fuel energy into the fuel converter and the useful energy created by the fuel converter over the drive cycle in kJ 
fc_out_kj 
scalar 
kJ 
all 
the useful energy out of the fuel converter over the drive cycle in kJ 
fc_retard_kj 
scalar 
kJ 
all 
the total negative work (i.e., retardation) on the fuel converter over the drive cycle 
Exhaust System (& Catalyst) Variables(Output Variables) 

Name 
Type 
Units 
Vehicle Type 
Description 
ex_cat_eff 
matrix 
– 
all 
HC, CO, NOx, and PM efficiency of converter 
ex_cat_tmp 
vector 
C 
all 
interior converter (monolith) temperature based on lumpedcapacitance thermal model 
ex_cat_tmp_old 
vector 
C 
all 
interior converter (monolith) temperature based on old method (exponential warmup or cooldown based on time fc is off or on) 
ex_cat_th_pwr 
vector 
W 
all 
thermal power (heat) from catalysis of emissions 
ex_gas_tmp 
matrix 
C 
all 
matrix of exhaust gas temperatures vs time: 
ex_tmp 
matrix 
C 
all 
exhaust system temperatures vs time: 
Miscellaneous and PostProcessing Output (Output Variables) 

Name 
Type 
Units 
Vehicle Type 
Description 
dist 
scalar 
mi 
all 
total distance traveled 
dt 
scalar 
s 
all 
size of the time step 
COgpmi 
scalar 
g/mi 
all 
drive cycle CO emissions 
co_gpm 
scalar 
g/mi 
all 
drive cycle CO emissions 
HCgpmi 
scalar 
g/mi 
all 
drive cycle HC emissions 
hc_gpm 
scalar 
g/mi 
all 
drive cycle HC emissions 
NOxgpmi 
scalar 
g/mi 
all 
drive cycle NOx emissions 
nox_gpm 
scalar 
g/mi 
all 
drive cycle NOx emissions 
pm_gpm 
scalar 
g/mi 
all 
drive cycle PM emissions 
gal 
vector 
gal 
all 
gallons of fuel used per time step 
hybrid 
Boolean 
– 
all 
hybrid vehicle flag: 1= vehicle is a hybrid, 2= vehicle is not a hybrid 
mpg 
scalar 
mi/gal 
all 
the average fuel economy for the drive cycle (for the type of fuel used) 
mpgge 
scalar 
mi/gal 
all 
drive cycle miles per gallon gasoline equivalent 
mpgde 
scalar 
mi/gal 
all 
drive cycle miles per gallon diesel equivalent 
gb_eta 
vector 
– 
all 
secondbysecond efficiency of the gearbox 
gb_eta_avg 
scalar 
– 
all 
drive cycle average efficiency of the gearbox 
gb_in_Jmax 
vector 
J 
all 
energy into the gearbox 
gb_out_Jmax 
vector 
J 
all 
energy out of the gearbox 
gb_pwr_in_a 
vector 
W 
all 
power achieved into the gearbox 
gb_pwr_out_a 
vector 
W 
all 
power achieved out of the gearbox 
fc_eta 
vector 
– 
all 
secondbysecond engine efficiency 
fc_eta_avg 
scalar 
– 
all 
drive cycle average engine efficiency 
fc_in_Jmax 
vector 
J 
all 
energy into the engine 
fc_in_W 
vector 
W 
all 
power into the engine 
fc_map_kW 
matrix 
kW 
all 
kilowatt output of the engine indexed by fc_map_spd and fc_map_trq 
fc_out_Jmax 
vector 
J 
all 
energy output of the engine 
fc_out_W 
vector 
W 
all 
power output of the engine 
aux_load_eff 
scalar 
– 
all 
the efficiency of the auxiliary load components 
aux_load_in_kj 
scalar 
kJ 
all 
the total auxiliary load (mechanical + electrical) input in kiloJoules 
aux_load_loss_kj 
scalar 
kJ 
all 
the loss of energy to the auxiliary load (in kJ) 
aux_load_out_kj 
scalar 
kJ 
all 
the output energy from the auxiliary load 
trace_miss 
vector 
mi/hr 
all 
a vector of the absolute difference in required speed of the cycle and the actual speed achieved by the vehicle 
trace_miss_allowance 
scalar 
mi/hr 
all 
GUI variable used to set the warning flag window. If trace_miss ever exceeds trace_miss_allowance, a warning will be sent to the warnings window in the GUI. The user does not normally need to change this variable. 
brake_loss_kj 
scalar 
kJ 
all 
the total energy lost to the brakes during the driving cycle in kJ 
gear_ratio 
vector 
– 
all 
a vector of the gear ratio for each gear setting. 
missed_deltaSOC 
Boolean 
– 
all 
stores whether the delta SOC was within a tolerance band of .005 (0 = false, 1 = true) 
missed_trace 
Boolean 
– 
all 
stores whether or not the the vehicle ever missed the trace by greater than the allowable margin 
road_load_kj 
scalar 
kJ 
all 
total energy required for vehicle to travel at the achieved speed and force over the drive cycle 
rolling_kj 
scalar 
kJ 
all 
total energy required for vehicle to overcome rolling resistance over the drive cycle 
All model and data files use a prefix followed by an underscore (’_’) that is the same as the prefix used for (nearly all of) the variables it defines, which in turn is in pointy brackets (<) at the end of the Simulink block in which those variables are used. Here are ADVISOR’s component file types:
ACC_*.M Accessory load files
CYC_*.M Driving cycle files, which define variables starting with cyc_, used in the block labeled <cyc
ESS_*.M Energy storage system data files, which likewise define variables starting with ess_, used in the block labeled <ess
EX_*.M Exhaust aftertreatment files (such as catalysts)
FC_*.M Fuel converter data files
FD_*.M Final drive data files
GB_*.M Gearbox data files
GC_*.M Generator/controller data files
MC_*.M Motor/controller data files
PTC_*.M Powertrain control data files, which define engine control, clutch control, and hybrid control strategy variables starting with vc_ and cs_, used in blocks labeled <vc and <cs
TC_*.MTorque coupler data files
VEH_*.M Vehicle data files
WH_*.M Wheel/axle data files
In addition to the above component data files, there are two other types that use prefixes:
BD_*.MDL Simulink block diagrams (models)
CV_*.M Complete vehicle files that include all necessary references to component files to define an entire vehicle
Listed below are a few commands that are frequently used to reduce and inspect ADVISOR’s input and output data. Matlab help is available on all of these commands by entering helpwin command, help command, or helpdesk at the command line. A very useful Matlab help feature is the ‘lookfor’ command, which searches the one line descriptions of all Matlab commands for the word that you enter. To use ‘lookfor,’ enter something like lookfor color at the command line.
Plotrelated commands
axis  Sets limits on the axes of a selected plot 
contour  Generates a contour plot of a matrix such as an efficiency map 
grid  Toggles grid lines on a selected plot 
hold  Allows plots to be overlaid 
plot  XY plot 
subplot  Allows multiple plots in the same figure window 
title  Puts a title on the selected plot 
xlabel  Labels the selected xaxis 
ylabel  Labels the selected yaxis 
zoom  Toggles zoom in/out capability for selected plot 
Other commands
find  Find instances of some condition in a vector 
sum  Sum up all elements of a vector 
trapz  Integrate one vector with respect to another 
‘Goto’ and ‘From’ blocks should only be used to pass ‘control’ commands or ‘sensor’ information, and should not be used to transmit torque, speed, or power from one drivetrain component to another.
Last Revised: 11July2001: mpo