Initializing help system before first use

XSLPmsaddcustompreset, XPRSmsaddcustompreset

Purpose
A combined version of XSLPmsaddjob and XSLPmsaddpreset. The preset described is loaded, topped up with the specific settings supplied
Topic areas
Multistart, Data Input
Synopsis
int XSLP_CC XSLPmsaddcustompreset( XSLPprob prob, const char *description, const int preset, const int maxjobs, const int ninitial, const int *colind, const double *initial, const int nintcontrols, const int *intcontrolid, const int *intcontrolval, const int ndblcontrols, const int *dblcontrolid, const double *dblcontrolval, void *data);
Arguments
prob 
The current SLP problem.
description 
Text description of the job. Used for messaging, may be NULL if not required.
preset 
Which preset to load.
maxjobs 
Maximum number of jobs to be added to the multistart pool.
ninitial 
Number of initial values to set.
colind 
Indices of the variables for which to set an initial value. May be NULL if no initial values are provided.
initial 
Initial values for the variables for which to set an initial value. May be NULL if no initial values are provided.
nintcontrols 
Number of integer controls to set.
intcontrolid 
The indices of the integer controls to be set. May be NULL if nintcontrols is zero.
intcontrolval 
The values of the integer controls to be set. May be NULL if nintcontrols is zero.
ndblcontrols 
Number of double controls to set.
dblcontrolid 
The indices of the double controls to be set. May be NULL if ndblcontrols is zero.
dblcontrolval 
The values of the double controls to be set. May be NULL if ndblcontrols is zero.
data 
Job specific user context pointer to be passed to the multistart callbacks.
Further information
1. This function allows for repeatedly calling the same multistart preset (e.g. initial values) using different basic controls.
2. The following presets are defined:
XSLP_MSSET_INITIALVALUES
generate maxjobs number of random base points.
XSLP_MSSET_SOLVERS
load all solvers.
XSLP_MSSET_SLP_BASIC
load the most typical SLP tuning settings. A maximum of maxjobs jobs are loaded.
XSLP_MSSET_SLP_EXTENDED
load a comprehensive set of SLP tuning settings. A maximum of maxjobs jobs are loaded.
XSLP_MSSET_KNITRO_BASIC
load the most typical Knitro tuning settings. A maximum of maxjobs jobs are loaded.
XSLP_MSSET_KNITRO_EXTENDED
load a comprehensive set of Knitro tuning settings. A maximum of maxjobs jobs are loaded.
XSLP_MSSET_INITIALFILTERED
generate maxjobs number of random base points, filtered by a merit function centred on initial feasibility.
3. See XSLP_MSMAXBOUNDRANGE for controlling the range in which initial values are generated.
Related topics
XSLPmsaddpreset, XSLPmsaddjob, XSLPmsclear

Parent Topic Library functions

© 2001-2025 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.