APMonitor Global Options
Global options in APMonitor configure and report application level information. Global options begin with the prefix APM. There are also Local Options that configure and report parameters associated with individual variables or parameters. Below is a list of all global options.
- APM.APPINFO
- APM.APPINFOCHG
- APM.APPSTATUS
- APM.AUTO_COLD
- APM.BAD_CYCLES
- APM.BNDS_CHK
- APM.COLDSTART
- APM.CSV_READ
- APM.CSV_WRITE
- APM.CTRL_HOR
- APM.CTRL_TIME
- APM.CTRL_UNITS
- APM.CTRLMODE
- APM.CV_TYPE
- APM.CV_WGT_SLOPE
- APM.CV_WGT_START
- APM.CYCLECOUNT
- APM.DBS_LEVEL
- APM.DBS_READ
- APM.DBS_WRITE
- APM.DIAGLEVEL
- APM.EV_TYPE
- APM.EV_WGT_SLOPE
- APM.FILTER
- APM.FRZE_CHK
- APM.HIST_HOR
- APM.HIST_UNITS
- APM.ICD_CALC
- APM.IMODE
- APM.ITERATIONS
- APM.LINEAR
- APM.MAX_ITER
- APM.MAX_MEMORY
- APM.MAX_TIME
- APM.MEAS_CHK
- APM.MV_DCOST_SLOPE
- APM.MV_STEP_HOR
- APM.MV_TYPE
- APM.NODES
- APM.OBJFCNVAL
- APM.OTOL
- APM.PRED_HOR
- APM.PRED_TIME
- APM.REDUCE
- APM.REPLAY
- APM.REQCTRLMODE
- APM.RTOL
- APM.SCALING
- APM.SENSITIVITY
- APM.SEQUENTIAL
- APM.SOLVER
- APM.SOLVESTATUS
- APM.SOLVETIME
- APM.SPECS
- APM.SPC_CHART
- APM.STREAM_LEVEL
- APM.TIME_SHIFT
- APM.WEB
- APM.WEB_MENU
- APM.WEB_REFRESH
- APM.WEB_PLOT_FREQ
An option can be changed from a MATLAB or Python script. Below is a command to set an option to run the model as a Nonlinear Control application with APM.IMODE=6.
apm_option(s,a,'apm.imode',6)
Output options can also be read after the solution with the command to access a tag from the database. If the tag does not exist, a value of -99999 is returned. In this case, the user wants to know if the application was solved successfully by retrieving the APM.APPSTATUS value.
success_check = apm_tag(s,a,'apm.appstatus')
In this case, the argument s='https://byu.apmonitor.com' is the server address and a='myApp' is the application name. When running a local server, the server address should be changed to s='https://127.0.0.1' or s='https://localhost' .
The following is a list of global options that may be set to configure an APMonitor application. It is a complete list of the configuration parameters for APM type parameters. Each section includes an indication of the variable type (Integer or Real), the default value, data flow, and a brief description. While this list is exhaustive, there are typically only a few of these that are used most commonly for estimation and control.