Function GMP::Instance::Generate(MP, name)

GMP::Instance::Generate

The function GMP::Instance::Generate generates a mathematical program instance from a symbolic mathematical program.

GMP::Instance::Generate(
     MP,             ! (input) a symbolic mathematical program
     [name]          ! (optional) a string expression
     )

Arguments

MP

A symbolic mathematical program in the set AllMathematicalPrograms. The mathematical program should have model type LP, MIP, QP, MIQP, QCP, MIQCP, NLP, MINLP, RMIP or RMINLP.

name

A string that holds the name for the mathematical program to be generated.

Return Value

A new element in the set AllGeneratedMathematicalPrograms with the name as specified by the name argument.

Note

  • If the second argument is not specified, or if it is the empty string, the name of the symbolic mathematical program is used to create a new element in the set AllGeneratedMathematicalPrograms.

  • If an element with name specified by the name argument is already present in the set AllGeneratedMathematicalPrograms the corresponding generated mathematical program will be replaced (or updated in case the same symbolic mathematical program is involved). In that case all existing solver sessions created for the generated mathematical program will be deleted.

  • It is possible to generate indexed mathematical program instances. See the example in Indexed Mathematical Program Instances of the Language Reference.

  • A callback procedure should be installed using the appropriate GMP procedure, (e.g., GMP::Instance::SetCallbackIterations) instead of using a suffix of the mathematical program (e.g., suffix CallbackIterations).

  • If an error occurs during the execution of GMP::Instance::Generate, e.g., if one of the constraints appears to be empty and infeasible, then the program status of the mathematical program will be set to Infeasible and the solver status to PreprocessorError.