DBS Parameters for Variables

The following is a list of parameters that may be found in the DBS file for variables listed in the INFO file. It is a complete list of the configuration parameters for FV, MV, SV, CV type parameters and variables. Each section includes an indication of the variable type (Integer or Real), the default value, data flow, and description.

  • COST
  • CRITICAL
  • DCOST
  • DMAX
  • DMAXHI
  • DMAXLO
  • DPRED
  • FSTATUS
  • FDELAY
  • LOWER
  • LSTVAL
  • MEAS
  • MEAS_GAP
  • MODEL
  • MV_STEP_HOR
  • NEWVAL
  • NXTVAL
  • OBJPCT
  • OSTATUS
  • OSTATUSCHG
  • PRED
  • PSTATUS
  • REQONCTRL
  • SP
  • SPHI
  • SPLO
  • STATUS
  • TAU
  • TR_OPEN
  • TR_INIT
  • UPPER
  • VDVL
  • VLHI
  • VLLO
  • WMEAS
  • WMODEL
  • WSP
  • WSPHI
  • WSPLO

COST

 Type: Real 
 Default Value: 0.0
 Data Flow: Input
 Description: Cost weight: (+)=minimize, (-)=maximize

CRITICAL

 Type: Integer 
 Default Value: 0
 Data Flow: Input
 Description: Critical: 0=OFF, 1=ON' 

DCOST

 Type: Real 
 Default Value: 0.00001
 Data Flow: Input
 Description: Delta cost penalty for MV movement

DMAX

 Type: Real 
 Default Value: 1.0e20
 Data Flow: Input
 Description: Delta MV maximum step per horizon interval

DMAXHI

 Type: Real 
 Default Value: 1.0e20
 Data Flow: Input
 Description: Delta MV positive maximum step per horizon interval

DMAXLO

 Type: Real 
 Default Value: -1.0e20
 Data Flow: Input
 Description: Delta MV negative maximum step per horizon interval

DPRED

 Type: Real 
 Default Value: 0.0
 Data Flow: Output
 Description: Delta prediction changes for each step' 

FSTATUS

 Type: Real 
 Default Value: 1.0
 Data Flow: Input
 Description: Feedback status: 1=ON, 0=OFF

FDELAY

 Type: Integer 
 Default Value: 0
 Data Flow: Input
 Description: Feedback delay: 0=No Delay, >=1 horizon steps for delay

LOWER

 Type: Real 
 Default Value: -1.0e20
 Data Flow: Input
 Description: Lower bound

LSTVAL

 Type: Real 
 Default Value: 1.0
 Data Flow: Output
 Description: Last value from previous solution

MEAS

 Type: Real 
 Default Value: 1.0
 Data Flow: Input
 Description: Measured value

MEAS_GAP

 Type: Real 
 Default Value: 1.0
 Data Flow: Input
 Description: Deadband for noise rejection of measurements in MHE

MODEL

 Type: Real 
 Default Value: 1.0
 Data Flow: Output
 Description: Model predicted value

MV_STEP_HOR

 Type: Integer 
 Default Value: 1 (for NLC.MV_STEP_HOR) or 0 (for MV(#).MV_STEP_HOR) 
 Data Flow: Input
 Description: Step length for manipulated variables: 0 uses NLC.MV_STEP_HOR as default

NEWVAL

 Type: Real 
 Default Value: 1.0
 Data Flow: Output
 Description: New value implemented by the estimator or controller (NEWVAL = MEAS when not in control)

NXTVAL

 Type: Real 
 Default Value: 1.0
 Data Flow: Output
 Description: Next value that the estimator or controller would implement were it on

OBJPCT

 Type: Real 
 Default Value: 0.0
 Data Flow: Output
 Description: Percent of objective function contibution considering all SV and CV variables

OSTATUS

 Type: Integer 
 Default Value: 0
 Data Flow: Input and Output
 Description: Bit encoding for status messages

OSTATUSCHG

 Type: Integer 
 Default Value: 0
 Data Flow: Input
 Description: Change in bit encoding for status messages

PRED

 Type: Real 
 Default Value: 1.0
 Data Flow: Output
 Description: Prediction horizon

PSTATUS

 Type: Integer 
 Default Value: 1
 Data Flow: Input
 Description: Instrument status: 1=GOOD, 0=BAD

REQONCTRL

 Type: Integer 
 Default Value: 0
 Data Flow: Input
 Description: Required for control mode to be ON (3): 1=ON, 0=OFF

SP

 Type: Real 
 Default Value: 0.0
 Data Flow: Input
 Description: Set point for squared error model

SPHI

 Type: Real 
 Default Value: 1.0e20
 Data Flow: Input
 Description: Set point high for linear error model

SPLO

 Type: Real 
 Default Value: -1.0e20
 Data Flow: Input
 Description: Set point low for linear error model

STATUS

 Type: Integer 
 Default Value: 0
 Data Flow: Input
 Description: Status: 1=ON, 0=OFF

TAU

 Type: Real 
 Default Value: 60.0
 Data Flow: Input
 Description: Time constant for controlled variable response

TR_OPEN

 Type: Real 
 Default Value: 1.0
 Data Flow: Input
 Description: Initial trajectory opening ratio (0=ref traj, 1=tunnel, 2=funnel)

TR_INIT

 Type: Integer
 Type: Real
 Default Value: 1
 Data Flow: Input
 Description: Traj initialization (0=dead-band, 1=re-center with coldstart/out-of-service, 2=re-center always)

UPPER

 Type: Real 
 Default Value: 1.0e20
 Data Flow: Input
 Description: Upper bound

VDVL

 Type: Real 
 Default Value: 1.0e20
 Data Flow: Input
 Description: Delta validity limit

VLHI

 Type: Real 
 Default Value: 1.0e20
 Data Flow: Input
 Description: Upper validity limit

VLLO

 Type: Real 
 Default Value: -1.0e20
 Data Flow: Input
 Description: Lower validity limit

WMEAS

 Type: Real 
 Default Value: 20.0
 Data Flow: Input
 Description: Objective function weight on measured value

WMODEL

 Type: Real 
 Default Value: 2.0d0
 Data Flow: Input
 Description: Objective function weight on model value

WSP

 Type: Real 
 Default Value: 1.0
 Data Flow: Input
 Description: Objective function weight on set point for squared error model

WSPHI

 Type: Real 
 Default Value: 1.0
 Data Flow: Input
 Description: Objective function weight on upper set point for linear error model

WSPLO

 Type: Real 
 Default Value: 1.0
 Data Flow: Input
 Description: Objective function weight on lower set point for linear error model