参数管理

int GRBgetdblparam(GRBenv *env, const char *paramname, double *valueP)

检索双精度值参数的值。

请注意，模型在创建时会获得其自己的环境副本。对原始环境的更改不会影响副本，反之亦然。如果您想查询该模型的参数值，请使用GRBgetenv来检索与该模型关联的环境。

Return value:

非零返回值表示在检索参数时发生了问题。 请参考错误代码表 以获取可能的返回值列表。可以通过调用GRBgeterrormsg 来获取错误的详细信息。

Arguments:

• env – 正在查询其参数值的环境。

• paramname – 参数的名称。请查阅 参数部分 以获取Gurobi参数的完整列表，包括它们的用途描述以及最小、最大和默认值。

• valueP – 请求参数的当前值应放置的位置。

Example:

double cutoff;
error = GRBgetdblparam(GRBgetenv(model), "Cutoff", &cutoff);

int GRBgetintparam(GRBenv *env, const char *paramname, int *valueP)

检索整数值参数的值。

请注意，模型在创建时会获得其自己的环境副本。对原始环境的更改不会影响副本，反之亦然。如果您想查询该模型的参数值，请使用GRBgetenv来检索与该模型关联的环境。

Return value:

非零返回值表示在检索参数时发生了问题。 请参考错误代码表 以获取可能的返回值列表。可以通过调用GRBgeterrormsg 来获取错误的详细信息。

Arguments:

• env – 正在查询其参数值的环境。

• paramname – 参数的名称。请查阅 参数部分 以获取Gurobi参数的完整列表，包括它们的用途描述以及最小值、最大值和默认值。

• valueP – 请求参数的当前值应放置的位置。

Example:

int limit;
error = GRBgetintparam(GRBgetenv(model), "SolutionLimit", &limit);

int GRBgetstrparam(GRBenv *env, const char *paramname, char *value)

检索字符串值参数的值。

请注意，模型在创建时会获得其自己的环境副本。对原始环境的更改不会影响副本，反之亦然。如果您想查询该模型的参数值，请使用GRBgetenv来检索与该模型关联的环境。

Return value:

非零返回值表示在检索参数时发生了问题。 请参考错误代码表 以获取可能的返回值列表。可以通过调用GRBgeterrormsg 来获取错误的详细信息。

Arguments:

• env – 正在查询其参数值的环境。

• paramname – 参数的名称。请查阅 参数部分 以获取Gurobi参数的完整列表，包括它们的用途描述以及最小、最大和默认值。

• value – 请求参数的当前值应放置的位置。

Example:

char logfilename[GRB_MAX_STRLEN];
error = GRBgetstrparam(GRBgetenv(model), "LogFile", logfilename);

int GRBsetdblparam(GRBenv *env, const char *paramname, double newvalue)

修改一个双值参数的值。

请注意，模型在创建时会获得其自己的环境副本。对原始环境的更改不会影响副本，反之亦然。如果您想更改该模型的参数值，请使用GRBgetenv来检索与该模型关联的环境。

Return value:

非零返回值表示在修改参数时发生了问题。请参考错误代码表以获取可能的返回值列表。可以通过调用GRBgeterrormsg来获取错误的详细信息。

Arguments:

• env – 正在修改其参数值的环境。

• paramname – 参数的名称。请查阅 参数部分 以获取Gurobi参数的完整列表，包括它们的用途描述以及最小、最大和默认值。

• newvalue – 参数所需的新值。

Example:

error = GRBsetdblparam(GRBgetenv(model), "Cutoff", 100.0);

int GRBsetintparam(GRBenv *env, const char *paramname, int newvalue)

修改一个整数值参数的值。

请注意，模型在创建时会获得其自己的环境副本。对原始环境的更改不会影响副本，反之亦然。如果您想更改该模型的参数值，请使用GRBgetenv来检索与该模型关联的环境。

Return value:

非零返回值表示在修改参数时发生了问题。请参考错误代码表以获取可能的返回值列表。可以通过调用GRBgeterrormsg来获取错误的详细信息。

Arguments:

• env – 正在修改其参数值的环境。

• paramname – 参数的名称。请查阅 参数部分 以获取Gurobi参数的完整列表，包括它们的用途描述以及最小值、最大值和默认值。

• newvalue – 参数所需的新值。

Example:

error = GRBsetintparam(GRBgetenv(model), "SolutionLimit", 5);

int GRBsetstrparam(GRBenv *env, const char *paramname, const char *newvalue)

修改字符串类型参数的值。

请注意，模型在创建时会获得其自己的环境副本。对原始环境的更改不会影响副本，反之亦然。如果您想更改该模型的参数值，请使用GRBgetenv来检索与该模型关联的环境。

Return value:

非零返回值表示在修改参数时发生了问题。请参考错误代码表以获取可能的返回值列表。可以通过调用GRBgeterrormsg来获取错误的详细信息。

Arguments:

• env – 正在修改其参数值的环境。

• paramname – 参数的名称。请查阅 参数部分 以获取Gurobi参数的完整列表，包括它们的用途描述以及最小、最大和默认值。

• newvalue – 参数所需的新值。

Example:

error = GRBsetstrparam(GRBgetenv(model), "LogFile", "/tmp/new.log");

int GRBsetparam(GRBenv *env, const char *paramname, const char *newvalue)

修改参数的值。

请注意，模型在创建时会获得其自己的环境副本。对原始环境的更改不会影响副本，反之亦然。如果您想更改该模型的参数值，请使用GRBgetenv来检索与该模型关联的环境。

Return value:

非零返回值表示在修改参数时发生了问题。请参考错误代码表以获取可能的返回值列表。可以通过调用GRBgeterrormsg来获取错误的详细信息。

Arguments:

• env – 正在修改其参数值的环境。

• paramname – 参数的名称。请查阅 参数部分 以获取Gurobi参数的完整列表，包括它们的用途描述以及最小、最大和默认值。

• newvalue – 参数所需的新值。

Example:

error = GRBsetparam(GRBgetenv(model), "Cutoff", "100.0");

int GRBgetdblparaminfo(GRBenv *env, const char *paramname, double *valueP, double *minP, double *maxP, double *defaultP)

检索关于双值参数的信息。具体来说，检索参数的当前值、允许的最小值和最大值，以及默认值。

Return value:

非零返回值表示在检索参数信息时发生了问题。 请参考错误代码表以获取可能的返回值列表。 可以通过调用GRBgeterrormsg来获取错误的详细信息。

Arguments:

• env – 正在查询其参数信息的环境。

• paramname – 参数的名称。请查阅 参数部分 以获取Gurobi参数的完整列表，包括它们的用途描述以及最小、最大和默认值。

• valueP – (可选) 指定参数的当前值应放置的位置。

• minP – （可选）指定参数的最小允许值应放置的位置。

• maxP – （可选）指定参数的最大允许值应放置的位置。

• defaultP – （可选）指定参数的默认值应放置的位置。

Example:

error = GRBgetdblparaminfo(GRBgetenv(model), "MIPGap", &currentGap,
                           &minAllowedGap, NULL, &defaultGap);

int GRBgetintparaminfo(GRBenv *env, const char *paramname, int *valueP, int *minP, int *maxP, int *defaultP)

检索关于整数值参数的信息。具体来说，检索参数的当前值、允许的最小值和最大值，以及默认值。

Return value:

非零返回值表示在检索参数信息时发生了问题。 请参考错误代码表 以获取可能的返回值列表。可以通过调用GRBgeterrormsg 来获取错误的详细信息。

Arguments:

• env – 正在查询其参数信息的环境。

• paramname – 参数的名称。请查阅 参数部分 以获取Gurobi参数的完整列表，包括它们的用途描述以及最小、最大和默认值。

• valueP – (可选) 指定参数的当前值应放置的位置。

• minP – （可选）指定参数的最小允许值应放置的位置。

• maxP – （可选）指定参数的最大允许值应放置的位置。

• defaultP – (可选) 指定参数的默认值应放置的位置。

Example:

error = GRBgetintparaminfo(GRBgetenv(model), "SolutionLimit", &current,
                           &minAllowedLimit, NULL, &defaultLimit);

int GRBgetstrparaminfo(GRBenv *env, const char *paramname, char *value, char *defaultP)

检索关于字符串值参数的信息。具体来说，检索参数的当前值和默认值。

Return value:

非零返回值表示在检索参数信息时发生了问题。 请参考错误代码表以获取可能的返回值列表。 可以通过调用GRBgeterrormsg来获取错误的详细信息。

Arguments:

• env – 正在查询其参数信息的环境。

• paramname – 参数的名称。请查阅 参数部分 以获取Gurobi参数的完整列表，包括它们的用途描述以及最小、最大和默认值。

• value – （可选）指定参数的当前值应放置的位置。

• defaultP – （可选）指定参数的默认值应放置的位置。

Example:

char defaultval[GRB_MAX_STRLEN];
char currentval[GRB_MAX_STRLEN];
error = GRBgetstrparaminfo(GRBgetenv(model), "LogFile", currentval,
                           defaultval);

int GRBreadparams(GRBenv *env, const char *filename)

从文件中导入一组参数修改。

请参考 参数部分以获取Gurobi参数的完整列表，包括它们的用途描述及其最小值、最大值和默认值。

Return value:

非零返回值表示在读取参数文件时发生了问题。请参考错误代码表以获取可能的返回值列表。可以通过调用GRBgeterrormsg来获取错误的详细信息。

Arguments:

• env – 参数更改应导入的环境。

• filename – 要读取的文件的路径。参数文件的后缀应为 .prm，可选地后跟 .zip, .gz, .bz2, .7z 或 .xz。

Example:

error = GRBreadparams(env, "/tmp/model.prm.bz2");

int GRBresetparams(GRBenv *env)

将所有参数的值重置为其默认值。

请参考 参数部分以获取Gurobi参数的完整列表，包括它们的用途描述及其最小值、最大值和默认值。

Return value:

非零返回值表示在重置参数时发生了问题。 请参考错误代码表 以获取可能的返回值列表。可以通过调用GRBgeterrormsg 获取错误的详细信息。

Arguments:

• env – 应该为其将参数重置为默认值的环境。

Example:

error = GRBresetparams(env);

int GRBwriteparams(GRBenv *env, const char *filename)

将更改后的参数值集合写入文件。

请参考 参数部分以获取Gurobi参数的完整列表，包括它们的用途描述及其最小值、最大值和默认值。

Return value:

非零返回值表示在写入参数文件时发生了问题。 请参考错误代码表以获取可能的返回值列表。 可以通过调用GRBgeterrormsg来获取错误的详细信息。

Arguments:

• env – 正在写入参数更改的环境。

• filename – 要写入文件的路径。参数文件的后缀应为 .prm，可选地后跟 .zip, .gz, .bz2, .7z 或 .xz。

Example:

error = GRBwriteparams(env, "/tmp/model.prm");