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 and the programming interface

© 2001-2026 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.