gurobipy 12.0.0b3__cp310-cp310-macosx_10_9_universal2.whl → 12.0.2__cp310-cp310-macosx_10_9_universal2.whl

gurobipy/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "12.0.0"
+__version__ = "12.0.2"
 
 from gurobipy._batch import Batch
 
@@ -14,6 +14,9 @@ from gurobipy._core import (
     SOS,
     Var,
     NLExpr,
+    TempConstr,
+    tuplelist,
+    tupledict,
 )
 
 from gurobipy._core import abs_, all_, and_, any_, max_, min_, norm, or_
@@ -54,10 +57,4 @@ from gurobipy._matrixapi import (
 
 from gurobipy._model import Model
 
-from gurobipy._tempconstr import TempConstr
-
-from gurobipy._tupledict import tupledict
-
-from gurobipy._tuplelist import tuplelist
-
 import gurobipy.nlfunc as nlfunc

gurobipy/__init__.pyi

@@ -105,7 +105,9 @@ def quicksum(__x: tupledict[Any, Var]) -> LinExpr: ...  # type: ignore[misc]
 @overload
 def quicksum(__x: Iterable[_LinExprLike]) -> LinExpr: ...  # type: ignore[misc]
 @overload
-def quicksum(__x: Iterable[_QuadExprLike]) -> QuadExpr: ...
+def quicksum(__x: Iterable[_QuadExprLike]) -> QuadExpr: ...  # type: ignore[misc]
+@overload
+def quicksum(__x: Iterable[_NLExprLike]) -> NLExpr: ...
 @overload
 def hstack(tup: Iterable[MVar]) -> MVar: ...  # type: ignore[misc]
 @overload

gurobipy/_grb.py

@@ -171,7 +171,7 @@ class GRB(object):
 
   VERSION_MAJOR     = 12
   VERSION_MINOR     = 0
-  VERSION_TECHNICAL = 0
+  VERSION_TECHNICAL = 2
 
 # Errors
 

gurobipy/_paramdetails.py

@@ -1,4 +1,5 @@
 # This file is automatically generated
+# Docs git ref: b0963771a0aba71f524d18b068056a7c9fdaed0f
 
 param_details = {
     "AggFill": {
@@ -62,7 +63,7 @@ param_details = {
         }
     },
     "BarIterLimit": {
-        "description": "Limits the number of barrier iterations performed. This parameter is\nrarely used. If you would like barrier to terminate early, it is\nalmost always better to use the BarConvTol parameter instead.\n\nOptimization returns with an ITERATION_LIMIT status if the limit is\nexceeded.\n\nNote:\n\n  Barrier only",
+        "description": "Limits the number of barrier iterations performed. This parameter is\nrarely used. If you would like barrier to terminate early, it is\nalmost always better to use the BarConvTol parameter instead.\n\nOptimization returns with an ITERATION_LIMIT status if the limit is\nexceeded.\n\nThis parameter is callback settable. It can be changed from within a\ncallback when the \"where\" value is \"PRESOLVED\", \"SIMPLEX\", \"MIP\",\n\"MIPSOL\", \"MIPNODE\", \"BARRIER\", or \"MULTIOBJ\" (see the Callback Codes\nsection for more information). How to do that for the different APIs\nis illustrated here. In case of a remote server, the change of a\nparameter from within a callback may not be taken into account\nimmediately.\n\nNote:\n\n  Barrier only",
         "name": "BarIterLimit",
         "values": {
             "default": 1000,
@@ -318,7 +319,7 @@ param_details = {
         }
     },
     "ConcurrentSettings": {
-        "description": "This command-line only parameter allows you to specify a comma-\nseparated list of .prm files that are used to set parameters for the\ndifferent instances in a concurrent MIP run.\n\nTo give an example, you could create two \".prm\" files with the\nfollowing contents\u2026\n\ns0.prm:\n\n   MIPFocus 0\n\ns1.prm:\n\n   MIPFocus 1\n\nIssuing the command \"gurobi_cl ConcurrentSettings=s0.prm,s1.prm\nmodel.mps\" would invoke the concurrent MIP solver, using parameter\nsetting MIPFocus=0 in one of the two concurrent solves and MIPFocus=1\nin the other.\n\nNote that if you want to run concurrent MIP on multiple machines, you\nmust also set the ConcurrentJobs parameter. The command for running\ndistributed concurrent optimization using the two example parameter\nfiles on two machines would be\n\n   > gurobi_cl ConcurrentJobs=2 ConcurrentSettings=s0.prm,s1.prm model.mps\n\nNote:\n\n  Command-line only (\"gurobi_cl\")",
+        "description": "This command-line only parameter allows you to specify a comma-\nseparated list of .prm files that are used to set parameters for the\ndifferent instances in a concurrent MIP run.\n\nTo give an example, you could create two \".prm\" files with the\nfollowing contents\u2026\n\ns0.prm:\n\n   MIPFocus 0\n\ns1.prm:\n\n   MIPFocus 1\n\nIssuing the command \"gurobi_cl ConcurrentSettings=s0.prm,s1.prm\nmodel.mps\" would invoke the concurrent MIP solver, using parameter\nsetting MIPFocus=0 in one of the two concurrent solves and MIPFocus=1\nin the other.\n\nNote that if you want to run concurrent MIP on multiple machines, you\nmust also set the ConcurrentJobs parameter. The command for running\ndistributed concurrent optimization using the two example parameter\nfiles on two machines would be\n\n   > gurobi_cl ConcurrentJobs=2 ConcurrentSettings=s0.prm,s1.prm model.mps\n\nNote:\n\n  Command-line only (\"gurobi_cl\"). See Concurrent environments for the\n  equivalent feature in the Gurobi APIs.",
         "name": "ConcurrentSettings",
         "values": {
             "default": "",
@@ -550,7 +551,7 @@ param_details = {
         "name": "FuncPieces",
         "values": {
             "default": 0,
-            "maximum": 2000000000,
+            "maximum": 200000000,
             "minimum": -2,
             "type": "int"
         }
@@ -666,7 +667,7 @@ param_details = {
         }
     },
     "InputFile": {
-        "description": "Specifies the name of a file that will be read before beginning a\ncommand-line optimization run. This parameter can be used to input a\nMIP start (a \".mst\" or \".sol\" file), MIP hints (a \".hnt\" file), a\nsimplex basis (a \".bas\" file), Gurobi attributes (a \".attr\" file), or\na set of parameter settings (a \".prm\" file) from the Gurobi command\nline. The suffix may optionally be followed by \".zip\", \".gz\", \".bz2\",\nor \".7z\" if the input files are compressed.\n\nNote:\n\n  Command-line only (\"gurobi_cl\")",
+        "description": "Specifies the name of a file that will be read before beginning a\ncommand-line optimization run. This parameter can be used to input a\nMIP start (a \".mst\" or \".sol\" file), MIP hints (a \".hnt\" file), a\nsimplex basis (a \".bas\" file), Gurobi attributes (a \".attr\" file), or\na set of parameter settings (a \".prm\" file) from the Gurobi command\nline. The suffix may optionally be followed by \".zip\", \".gz\", \".bz2\",\n\".7z\" or \".xz\" if the input files are compressed.\n\nNote:\n\n  Command-line only (\"gurobi_cl\"), can be used multiple times\n\nFor examples of how to use this parameter, refer to the Reading Input\nFiles section.",
         "name": "InputFile",
         "values": {
             "default": "",
@@ -770,7 +771,7 @@ param_details = {
         }
     },
     "LogToConsole": {
-        "description": "Enables or disables console logging. Use OutputFlag to shut off all\nlogging.\n\nNote that this refers to all the output of Gurobi to the console\nincluding the various display and print functions provided by the API\nin interactive environments. It also disables logging on the remote\nside of Instant Cloud or Compute Server environments.",
+        "description": "Enables or disables console logging. Note that this refers to the\noutput of Gurobi to the console. This includes the various display and\nprint functions provided by the API in interactive environments.\n\nUse OutputFlag to shut off all logging.",
         "name": "LogToConsole",
         "values": {
             "default": 1,
@@ -870,7 +871,7 @@ param_details = {
         }
     },
     "MinRelNodes": {
-        "description": "Number of nodes to explore in the minimum relaxation heuristic. Note\nthat this heuristic is only applied at the end of the MIP root, and\nonly when no other root heuristic finds a feasible solution.\n\nThis heuristic is quite expensive, and generally produces poor quality\nsolutions. You should generally only use it if other means, including\nexploration of the tree with default settings, fail to produce a\nfeasible solution.\n\nThe default value automatically chooses whether to apply the\nheuristic. It will only rarely choose to do so.\n\nNote:\n\n  Only affects mixed integer programming (MIP) models",
+        "description": "Number of nodes to explore in the minimum relaxation heuristic.\n\nThis heuristic is quite expensive, and generally produces poor quality\nsolutions. You should generally only use it if other means, including\nexploration of the tree with default settings, fail to produce a\nfeasible solution.\n\nThe default value automatically chooses whether to apply the\nheuristic. It will only rarely choose to do so.\n\nNote:\n\n  Only affects mixed integer programming (MIP) models",
         "name": "MinRelNodes",
         "values": {
             "default": -1,
@@ -978,7 +979,7 @@ param_details = {
         }
     },
     "NodeLimit": {
-        "description": "Limits the number of MIP nodes explored. Optimization returns with an\nNODE_LIMIT status if the limit is exceeded. Note that if multiple\nthreads are used for the optimization, the actual number of explored\nnodes may be slightly larger than the set limit.\n\nNote:\n\n  Only affects mixed integer programming (MIP) models",
+        "description": "Limits the number of MIP nodes explored. Optimization returns with an\nNODE_LIMIT status if the limit is exceeded. Note that if multiple\nthreads are used for the optimization, the actual number of explored\nnodes may be slightly larger than the set limit.\n\nThis parameter is callback settable. It can be changed from within a\ncallback when the \"where\" value is \"PRESOLVED\", \"SIMPLEX\", \"MIP\",\n\"MIPSOL\", \"MIPNODE\", \"BARRIER\", or \"MULTIOBJ\" (see the Callback Codes\nsection for more information). How to do that for the different APIs\nis illustrated here. In case of a remote server, the change of a\nparameter from within a callback may not be taken into account\nimmediately.\n\nNote:\n\n  Only affects mixed integer programming (MIP) models",
         "name": "NodeLimit",
         "values": {
             "default": 1e+100,
@@ -1086,7 +1087,7 @@ param_details = {
         }
     },
     "OutputFlag": {
-        "description": "Enables or disables solver output. Use LogFile and LogToConsole for\nfiner-grain control. Setting OutputFlag to 0 is equivalent to setting\nLogFile to \"\"\"\" and LogToConsole to 0.",
+        "description": "Enables or disables solver output. Use LogFile and LogToConsole for\nfiner-grain control. Setting OutputFlag to 0 is equivalent to setting\nLogFile to \"\"\"\" and LogToConsole to 0.\n\nNote that server-side logging is always active for remote jobs run on\nGurobi Instant Cloud, Compute Server, or Cluster Manager. This is not\nimpacted by any user parameter settings.",
         "name": "OutputFlag",
         "values": {
             "default": 1,
@@ -1106,7 +1107,7 @@ param_details = {
         }
     },
     "PSDTol": {
-        "description": "Sets a limit on the amount of diagonal perturbation that the optimizer\nis allowed to perform on a Q matrix in order to correct minor PSD\nviolations. If a larger perturbation is required, the optimizer will\nterminate with a \"GRB_ERROR_Q_NOT_PSD\" error.\n\nNote:\n\n  Only affects QP, QCP, MIQP, and MIQCP models",
+        "description": "Sets a limit on the amount of diagonal perturbation that the optimizer\nis allowed to perform on a Q matrix in order to correct minor PSD\nviolations. If a larger perturbation is required, the optimizer will\nterminate with a Q_NOT_PSD error.\n\nNote:\n\n  Only affects QP, QCP, MIQP, and MIQCP models",
         "name": "PSDTol",
         "values": {
             "default": 1e-06,
@@ -1156,7 +1157,7 @@ param_details = {
         }
     },
     "PoolSearchMode": {
-        "description": "Selects different modes for exploring the MIP search tree. With the\ndefault setting (\"PoolSearchMode=0\"), the MIP solver tries to find an\noptimal solution to the model. It keeps other solutions found along\nthe way, but those are incidental. By setting this parameter to a non-\ndefault value, the MIP search will continue after the optimal solution\nhas been found in order to find additional, high-quality solutions.\nWith a non-default value (\"PoolSearchMode=1\" or \"PoolSearchMode=2\"),\nthe MIP solver will try to find \"n\" solutions, where \"n\" is determined\nby the value of the PoolSolutions parameter. With a setting of 1,\nthere are no guarantees about the quality of the extra solutions,\nwhile with a setting of 2, the solver will find the \"n\" best\nsolutions. The cost of the solve will increase with increasing values\nof this parameter.\n\nOnce optimization is complete, the PoolObjBound attribute can be used\nto evaluate the quality of the solutions that were found. For example,\na value of \"PoolObjBound=100\" indicates that there are no other\nsolutions with objective better 100, and thus that any known solutions\nwith objective better than 100 are better than any as-yet undiscovered\nsolutions.\n\nNote:\n\n  Only affects mixed integer programming (MIP) models",
+        "description": "Selects different modes for exploring the MIP search tree. With the\ndefault setting (\"PoolSearchMode=0\"), the MIP solver tries to find an\noptimal solution to the model. It keeps other solutions found along\nthe way, but those are incidental. By setting this parameter to a non-\ndefault value, the MIP search will continue after the optimal solution\nhas been found in order to find additional, high-quality solutions.\nWith a non-default value (\"PoolSearchMode=1\" or \"PoolSearchMode=2\"),\nthe MIP solver will try to find \"n\" solutions, where \"n\" is determined\nby the value of the PoolSolutions parameter. With a setting of 1,\nthere are no guarantees about the quality of the extra solutions,\nwhile with a setting of 2, the solver will find the \"n\" best\nsolutions. The cost of the solve will increase with increasing values\nof this parameter.\n\nOnce optimization is complete, the PoolObjBound attribute can be used\nto evaluate the quality of the solutions that were found. For example,\na value of \"PoolObjBound=100\" indicates that there are no other\nsolutions with objective better 100, and thus that any known solutions\nwith objective better than 100 are better than any as-yet undiscovered\nsolutions.\n\nSee Solution Pool for more information about solution pools, including\nsubtleties and limitations.\n\nNote:\n\n  Only affects mixed integer programming (MIP) models",
         "name": "PoolSearchMode",
         "values": {
             "default": 0,
@@ -1306,7 +1307,7 @@ param_details = {
         }
     },
     "PumpPasses": {
-        "description": "Number of passes of the feasibility pump heuristic. Note that this\nheuristic is only applied at the end of the MIP root.\n\nThis heuristic is quite expensive, and generally produces poor quality\nsolutions. You should generally only use it if other means, including\nexploration of the tree with default settings, fail to produce a\nfeasible solution.\n\nNote:\n\n  Only affects mixed integer programming (MIP) models",
+        "description": "Number of passes of the feasibility pump heuristic.\n\nThis heuristic is quite expensive, and generally produces poor quality\nsolutions. You should generally only use it if other means, including\nexploration of the tree with default settings, fail to produce a\nfeasible solution.\n\nThis parameter is callback settable. It can be changed from within a\ncallback when the \"where\" value is \"PRESOLVED\", \"SIMPLEX\", \"MIP\",\n\"MIPSOL\", \"MIPNODE\", \"BARRIER\", or \"MULTIOBJ\" (see the Callback Codes\nsection for more information). How to do that for the different APIs\nis illustrated here. In case of a remote server, the change of a\nparameter from within a callback may not be taken into account\nimmediately.\n\nNote:\n\n  Only affects mixed integer programming (MIP) models",
         "name": "PumpPasses",
         "values": {
             "default": -1,
@@ -1376,7 +1377,7 @@ param_details = {
         }
     },
     "ResultFile": {
-        "description": "Specifies the name of the result file to be written upon completion of\noptimization. The type of the result file is determined by the file\nsuffix. The most commonly used suffixes are \".sol\" (to capture the\nsolution vector), \".bas\" (to capture the simplex basis), and \".mst\"\n(to capture the solution vector on the integer variables). You can\nalso write a \".ilp\" file (to capture the IIS for an infeasible model),\nor a \".mps\", \".rew\", \".lp\", or \".rlp\" file (to capture the original\nmodel), or a \".dua\" or \".dlp\" file (to capture the dual of a pure LP\nmodel). The file suffix may optionally be followed by \".gz\", \".bz2\",\nor \".7z\", which produces a compressed result.\n\nMore information on the file formats can be found in the File Format\nsection.",
+        "description": "Specifies the name of the result file to be written upon completion of\noptimization. The type of the result file is determined by the file\nsuffix. The most commonly used suffixes are \".sol\" (to capture the\nsolution vector), \".bas\" (to capture the simplex basis), and \".mst\"\n(to capture the solution vector on the integer variables). You can\nalso write a \".ilp\" file (to capture the IIS for an infeasible model),\nor a \".mps\", \".rew\", \".lp\", or \".rlp\" file (to capture the original\nmodel), or a \".dua\" or \".dlp\" file (to capture the dual of a pure LP\nmodel). The file suffix may optionally be followed by \".zip\", \".gz\",\n\".bz2\", \".7z\" or \".xz\", which produces a compressed result.\n\nMore information on the file formats can be found in the File Format\nsection.",
         "name": "ResultFile",
         "values": {
             "default": "",
@@ -1600,7 +1601,7 @@ param_details = {
         }
     },
     "TimeLimit": {
-        "description": "Limits the total time expended (in seconds). Optimization returns with\na TIME_LIMIT status if the limit is exceeded.\n\nNote that optimization may not stop immediately upon hitting the time\nlimit. It will stop after performing the required additional\ncomputations of the attributes associated with the terminated\noptimization. As a result, the Runtime attribute may be larger than\nthe specified TimeLimit upon completion, and repeating the\noptimization with a TimeLimit set to the Runtime attribute of the\nstopped optimization may result in additional computations and a\nlarger attribute value.",
+        "description": "Limits the total time expended (in seconds). Optimization returns with\na TIME_LIMIT status if the limit is exceeded.\n\nNote that optimization may not stop immediately upon hitting the time\nlimit. It will stop after performing the required additional\ncomputations of the attributes associated with the terminated\noptimization. As a result, the Runtime attribute may be larger than\nthe specified TimeLimit upon completion, and repeating the\noptimization with a TimeLimit set to the Runtime attribute of the\nstopped optimization may result in additional computations and a\nlarger attribute value.\n\nThis parameter is callback settable. It can be changed from within a\ncallback when the \"where\" value is \"PRESOLVED\", \"SIMPLEX\", \"MIP\",\n\"MIPSOL\", \"MIPNODE\", \"BARRIER\", or \"MULTIOBJ\" (see the Callback Codes\nsection for more information). How to do that for the different APIs\nis illustrated here. In case of a remote server, the change of a\nparameter from within a callback may not be taken into account\nimmediately.",
         "name": "TimeLimit",
         "values": {
             "default": 1e+100,
@@ -1636,7 +1637,7 @@ param_details = {
         }
     },
     "TuneCriterion": {
-        "description": "Modifies the tuning criterion for the tuning tool. The primary tuning\ncriterion is always to minimize the runtime required to find a proven\noptimal solution. However, for MIP models that don\u2019t solve to\noptimality within the specified time limit, a secondary criterion is\nneeded. Set this parameter to 1 to use the optimality gap as the\nsecondary criterion. Choose a value of 2 to use the objective of the\nbest feasible solution found. Choose a value of 3 to use the best\nobjective bound. Choose 0 to ignore the secondary criterion and focus\nentirely on minimizing the time to find a proven optimal solution. The\ndefault value of -1 chooses automatically.\n\nNote that for multi-objective problems value 1 and 3 are unsupported.\nSee the Multiple Objectives section for more details on this.",
+        "description": "Modifies the tuning criterion for the tuning tool. The primary tuning\ncriterion is always to minimize the runtime required to find a proven\noptimal solution. However, for MIP models that don\u2019t solve to\noptimality within the specified time limit, a secondary criterion is\nneeded. Set this parameter to 1 to use the optimality gap as the\nsecondary criterion. Choose a value of 2 to use the objective of the\nbest feasible solution found. Choose a value of 3 to use the best\nobjective bound. Choose 0 to ignore the secondary criterion and focus\nentirely on minimizing the time to find a proven optimal solution. The\ndefault value of -1 chooses automatically.\n\nNote that values 1 and 3 are unsupported for multi-objective problems.",
         "name": "TuneCriterion",
         "values": {
             "default": -1,
@@ -1763,9 +1764,9 @@ param_details = {
             "type": "int"
         }
     },
-    "UserName": {
+    "Username": {
         "description": "Identify the user connecting to the Remote Services Manager.\n\nYou can provide either a username and password, or an access ID and a\nsecret key, to authenticate your connection to a Cluster Manager.\n\nYou can set this parameter through either a \"gurobi.lic\" file (using\n\"USERNAME=YOUR_USERNAME\") or an empty environment. Changing the\nparameter after your environment has been started will result in an\nerror.\n\nNote:\n\n  Cluster Manager only",
-        "name": "UserName",
+        "name": "Username",
         "values": {
             "default": "",
             "type": "string"
@@ -1789,6 +1790,22 @@ param_details = {
             "type": "string"
         }
     },
+    "WLSConfig": {
+        "description": "When using a WLS On Demand license, this parameter can be used to\nspecify which configuration to use.  If not specified, the\nconfiguration used will be the default configuration specified for\nthat license.",
+        "name": "WLSConfig",
+        "values": {
+            "default": "",
+            "type": "string"
+        }
+    },
+    "WLSProxy": {
+        "description": "Comma separated list of addresses of the WLS proxies to connect to.\nWhen using a WLS On Demand license, this parameter can be used to\nspecify the URLs to which Gurobi will connect to report usage. The\ndefault value (an empty string) is equivalent to\n\"http://localhost:61099\".",
+        "name": "WLSProxy",
+        "values": {
+            "default": "",
+            "type": "string"
+        }
+    },
     "WLSSecret": {
         "description": "When using a WLS license, set this parameter to the secret key for\nyour license. You can retrieve this string from your account on the\nGurobi Web License Manager site.",
         "name": "WLSSecret",
@@ -1826,7 +1843,7 @@ param_details = {
         }
     },
     "WorkLimit": {
-        "description": "Limits the total work expended (in work units). Optimization returns\nwith a WORK_LIMIT status if the limit is exceeded.\n\nIn contrast to the TimeLimit, work limits are deterministic. This\nmeans that on the same hardware and with the same parameter and\nattribute settings, a work limit will stop the optimization of a given\nmodel at the exact same point every time. One work unit corresponds\nvery roughly to one second on a single thread, but this greatly\ndepends on the hardware on which Gurobi is running and the model that\nis being solved.\n\nNote that optimization may not stop immediately upon hitting the work\nlimit. It will stop when the optimization is next in a deterministic\nstate, and it will then perform the required additional computations\nof the attributes associated with the terminated optimization. As a\nresult, the Work attribute may be larger than the specified WorkLimit\nupon completion, and repeating the optimization with a WorkLimit set\nto the Work attribute of the stopped optimization may result in\nadditional computations and a larger attribute value.",
+        "description": "Limits the total work expended (in work units). Optimization returns\nwith a WORK_LIMIT status if the limit is exceeded.\n\nIn contrast to the TimeLimit, work limits are deterministic. This\nmeans that on the same hardware and with the same parameter and\nattribute settings, a work limit will stop the optimization of a given\nmodel at the exact same point every time. One work unit corresponds\nvery roughly to one second on a single thread, but this greatly\ndepends on the hardware on which Gurobi is running and the model that\nis being solved.\n\nNote that optimization may not stop immediately upon hitting the work\nlimit. It will stop when the optimization is next in a deterministic\nstate, and it will then perform the required additional computations\nof the attributes associated with the terminated optimization. As a\nresult, the Work attribute may be larger than the specified WorkLimit\nupon completion, and repeating the optimization with a WorkLimit set\nto the Work attribute of the stopped optimization may result in\nadditional computations and a larger attribute value.\n\nThis parameter is callback settable. It can be changed from within a\ncallback when the \"where\" value is \"PRESOLVED\", \"SIMPLEX\", \"MIP\",\n\"MIPSOL\", \"MIPNODE\", \"BARRIER\", or \"MULTIOBJ\" (see the Callback Codes\nsection for more information). How to do that for the different APIs\nis illustrated here. In case of a remote server, the change of a\nparameter from within a callback may not be taken into account\nimmediately.",
         "name": "WorkLimit",
         "values": {
             "default": 1e+100,
@@ -1862,7 +1879,7 @@ param_details = {
         }
     },
     "ZeroObjNodes": {
-        "description": "Number of nodes to explore in the zero objective heuristic. Note that\nthis heuristic is only applied at the end of the MIP root, and only\nwhen no other root heuristic finds a feasible solution.\n\nThis heuristic is quite expensive, and generally produces poor quality\nsolutions. You should generally only use it if other means, including\nexploration of the tree with default settings, fail to produce a\nfeasible solution.\n\nNote:\n\n  Only affects mixed integer programming (MIP) models",
+        "description": "Number of nodes to explore in the zero objective heuristic.\n\nThis heuristic is quite expensive, and generally produces poor quality\nsolutions. You should generally only use it if other means, including\nexploration of the tree with default settings, fail to produce a\nfeasible solution.\n\nNote:\n\n  Only affects mixed integer programming (MIP) models",
         "name": "ZeroObjNodes",
         "values": {
             "default": -1,

gurobipy/nlfunc.py

@@ -0,0 +1,32 @@
+"""gurobipy nonlinear functions module
+
+This module contains a number of functions for creating nonlinear expressions.
+Each function can be called with any modeling object and returns an "NLExpr" or
+"MNLExpr" representing the corresponding nonlinear expression.  The resulting
+object can be used to add nonlinear constraints to the model. For example::
+
+   import gurobipy as gp
+   from gurobipy import GRB, nlfunc
+
+   with gp.Env() as env, gp.Model(env=env) as model:
+
+       x = model.addVar(lb=-GRB.INFINITY, name="x")
+       y = model.addVar(lb=-GRB.INFINITY, name="y")
+       z = model.addVar(lb=-GRB.INFINITY, name="z")
+
+       # Create a constraint specifying z = sin(x + y)
+       model.addConstr(z == nlfunc.sin(x + y))
+"""
+
+from gurobipy._helpers import (
+    sqrt,
+    sin,
+    cos,
+    tan,
+    exp,
+    log,
+    log2,
+    log10,
+    logistic,
+    square,
+)

{gurobipy-12.0.0b3.dist-info → gurobipy-12.0.2.dist-info}/METADATA

@@ -1,78 +1,83 @@
 Metadata-Version: 2.1
 Name: gurobipy
-Version: 12.0.0b3
+Version: 12.0.2
 Summary: Python interface to Gurobi
 Home-page: https://www.gurobi.com
 Author: Gurobi Optimization, LLC
 License: Proprietary
+Project-URL: Documentation, https://docs.gurobi.com
 Keywords: optimization,mip,lp
 Platform: Windows
 Platform: Linux
 Platform: macOS
-Description-Content-Type: text/x-rst
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Provides-Extra: matrixapi
 Requires-Dist: numpy; extra == "matrixapi"
 Requires-Dist: scipy; extra == "matrixapi"
 
-The Gurobi Optimizer is a mathematical optimization software library
-for solving mixed-integer linear and quadratic optimization problems.
+![Python versions](https://img.shields.io/badge/python-3.9%20|%203.10%20|%203.11%20|%203.12%20|%203.13-blue)
+![PyPI - Downloads](https://img.shields.io/pypi/dm/gurobipy)
+[![Gurobi Documentation](https://img.shields.io/badge/Help-Gurobi%20Documentation-red)](https://docs.gurobi.com/)
 
-This package comes with a trial license that allows you to solve
-problems of limited size.  As a student or staff member of an academic
-institution you qualify for a free, full product license. For
-more information, see:
+The Gurobi Optimizer is a mathematical optimization software library for solving mixed-integer linear and quadratic optimization problems.
 
-* https://www.gurobi.com/academia/academic-program-and-licenses/
+This package comes with a trial license that allows you to solve problems of limited size. As a student or staff member of an academic institution, you qualify for a free, full product license. For more information, see:
 
-For a commercial evaluation, you can `request an evaluation license`_.
+- [Academic Program and Licenses](https://www.gurobi.com/academia/academic-program-and-licenses/)
 
-.. _request an evaluation license: https://www.gurobi.com/free-trial/?utm_source=internal&utm_medium=documentation&utm_campaign=fy21_pipinstall_eval_pypipointer&utm_content=c_na&utm_term=pypi
+For a commercial evaluation, you can [request an evaluation license](https://www.gurobi.com/free-trial/?utm_source=internal&utm_medium=documentation&utm_campaign=fy21_pipinstall_eval_pypipointer&utm_content=c_na&utm_term=pypi).
 
 Other useful resources to get started:
 
-* https://www.gurobi.com/documentation/
-* https://support.gurobi.com/hc/en-us/community/topics
+- [Gurobi Documentation](https://docs.gurobi.com/)
+- [Gurobi Community](https://support.gurobi.com/hc/en-us/community/topics)
 
-A simple example
-----------------
+## A simple example
 
-.. code::
+```python
+# Solve the following MIP:
+#  maximize
+#        x +   y + 2 z
+#  subject to
+#        x + 2 y + 3 z <= 4
+#        x +   y       >= 1
+#        x, y, z binary
 
-  # Solve the following MIP:
-  #  maximize
-  #        x +   y + 2 z
-  #  subject to
-  #        x + 2 y + 3 z <= 4
-  #        x +   y       >= 1
-  #        x, y, z binary
+import gurobipy as gp
 
-  import gurobipy as gp
+# Create a new model
+m = gp.Model()
 
-  # Create a new model
-  m = gp.Model()
+# Create variables
+x = m.addVar(vtype='B', name="x")
+y = m.addVar(vtype='B', name="y")
+z = m.addVar(vtype='B', name="z")
 
-  # Create variables
-  x = m.addVar(vtype='B', name="x")
-  y = m.addVar(vtype='B', name="y")
-  z = m.addVar(vtype='B', name="z")
+# Set objective function
+m.setObjective(x + y + 2 * z, gp.GRB.MAXIMIZE)
 
-  # Set objective function
-  m.setObjective(x + y + 2 * z, gp.GRB.MAXIMIZE)
+# Add constraints
+m.addConstr(x + 2 * y + 3 * z <= 4)
+m.addConstr(x + y >= 1)
 
-  # Add constraints
-  m.addConstr(x + 2 * y + 3 * z <= 4)
-  m.addConstr(x + y >= 1)
+# Solve it!
+m.optimize()
 
-  # Solve it!
-  m.optimize()
+print(f"Optimal objective value: {m.objVal}")
+print(f"Solution values: x={x.X}, y={y.X}, z={z.X}")
+```
 
-  print(f"Optimal objective value: {m.objVal}")
-  print(f"Solution values: x={x.X}, y={y.X}, z={z.X}")
-
-
-Licensing information
----------------------
+# Licensing information
 
 GUROBI OPTIMIZATION, LLC
 END-USER LICENSE AGREEMENT 

gurobipy-12.0.2.dist-info/RECORD

@@ -0,0 +1,28 @@
+gurobipy/__init__.py,sha256=I943C3a0TLeRzxInhXWDT1bZFlWVBxjM0S2_y8dpiK8,918
+gurobipy/__init__.pyi,sha256=eZnx_O465OWVpALd4GifdxoQIUxAXEkfLIog9Ra2vv0,96342
+gurobipy/_attrconst.py,sha256=MiaSyl6PgSW0UTT8aboeGoPqhH_wY8rN1tEIvUNLRDY,16616
+gurobipy/_attrutil.cpython-310-darwin.so,sha256=JI1_OHrxWECbJ1IR2CnlgBsTvNlkgTqMG34n--ZS_Fg,343248
+gurobipy/_batch.cpython-310-darwin.so,sha256=Kztgc4nEtKybQccsKHUq3_fMzOBX0DxV5oq3wj62p0Y,254208
+gurobipy/_callbackconst.py,sha256=1AfVcVmzdGapyreB8VW3vW4XNZu-s-g4c7gCRJno-EA,6797
+gurobipy/_core.cpython-310-darwin.so,sha256=swWJKtppA5M2fZqlArioTjRkAc8gESVE9NOJthtdejQ,2907616
+gurobipy/_errorconst.py,sha256=6dzCQrZIhz7Drzmez7QVN8Q0JGgIqSABGdps6IMtC3U,3257
+gurobipy/_exception.cpython-310-darwin.so,sha256=k1DDDvGiM-fHZWD4nhnf-uH387AmbpZuME-TSqky-9k,162296
+gurobipy/_grb.py,sha256=NRO1MbXG99BoigZZ9PePD5y9F4JheEkSVdd3-mEwMX4,7261
+gurobipy/_helpers.cpython-310-darwin.so,sha256=8uzw2OQiPtAMesbdljWQN_66PnX7IhiTghMUiIQ45uU,236272
+gurobipy/_matrixapi.cpython-310-darwin.so,sha256=EyRMQQ40ux0ba2HjdGBTJSlnQwEWRpAGRKyOPo5ePrI,3911384
+gurobipy/_model.cpython-310-darwin.so,sha256=ci6sZ5VMuDlqG5jg_IeIX5DE7dBDvkq3O7i2dMhzxRU,3512016
+gurobipy/_modelutil.cpython-310-darwin.so,sha256=QZgd4plGqJf91_gBnlMgbenmFyCsb4R46z-rCi-aijI,382024
+gurobipy/_paramconst.py,sha256=FJCm2d9JwaoelXv0P1zhtWeZGSmzS5ooM8zqvlXzBqc,19678
+gurobipy/_paramdetails.py,sha256=KAB0U1H6XJoHNwaaf9cMOrW-7l1-OjltpX2qLPVRTWQ,151440
+gurobipy/_statusconst.py,sha256=ZClEP0VXRsAWLzj5iVozzUgHfpfy4svJwFuY1DyNZN8,1601
+gurobipy/_util.cpython-310-darwin.so,sha256=1RemEWnlytMRUuHd7twJq4TJdA2rFk-OJQl-f-JwRc0,282960
+gurobipy/nlfunc.py,sha256=YoWLN6Hqr6qX-WkcxZ0_9XjMeOqSyNErMf2dAe8Jlr4,870
+gurobipy/nlfunc.pyi,sha256=ict_m30E7sNMQE852db8wxRQtkgadda54sS9HeObKBw,1178
+gurobipy/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gurobipy/.libs/gurobi.lic,sha256=9xDz4iLWRWHiICr_Ify12Lmd0NIfhIeObN_YbVJawnM,90
+gurobipy/.libs/libgurobi120.dylib,sha256=fGzodDo-gjrcNhV1Lj3nL1J3AMIrMBuXhbGzaHu4G0k,15726752
+gurobipy-12.0.2.dist-info/LICENSE.txt,sha256=EJaZyhnM1ArhpFDQ9ZGJ_o5LEtwq5uRJga4dpxwMu7Q,156613
+gurobipy-12.0.2.dist-info/METADATA,sha256=TO0CHrEbsJZ1qM66UlFXgBURIbZMf7D1REiKWL6izow,16432
+gurobipy-12.0.2.dist-info/WHEEL,sha256=_4-9bb7QIwAHvf_bVnSA8pF2cWt5z9quG49FBKitXRc,114
+gurobipy-12.0.2.dist-info/top_level.txt,sha256=lI8imVf2_cKV2kVT6NVXJ4sH0ib8oAKeh06ysN_0_Bg,9
+gurobipy-12.0.2.dist-info/RECORD,,

gurobipy-12.0.0b3.dist-info/RECORD

@@ -1,31 +0,0 @@
-gurobipy/__init__.py,sha256=AlodDZMFyLtMhbmOBTMG-NseRRBwWc7-_Uq6LKzpv3o,1003
-gurobipy/__init__.pyi,sha256=jElynesXXozDyEfib3-Wei91F-2UAE6GLbQTbn251tE,96254
-gurobipy/_attrconst.py,sha256=MiaSyl6PgSW0UTT8aboeGoPqhH_wY8rN1tEIvUNLRDY,16616
-gurobipy/_attrutil.cpython-310-darwin.so,sha256=_rvNQCGCEf7ApbJGFZ_PXF2bPycpkkBr_UiFty93w5Y,343360
-gurobipy/_batch.cpython-310-darwin.so,sha256=A8J5rtGFar9vqiMPpbIBeWenfphnXS4blPxPByo075s,254208
-gurobipy/_callbackconst.py,sha256=1AfVcVmzdGapyreB8VW3vW4XNZu-s-g4c7gCRJno-EA,6797
-gurobipy/_core.cpython-310-darwin.so,sha256=P6amWbLNA8LH9lT2bvfOWhtaBYQcLsFWPfORDgTBBqg,2409472
-gurobipy/_errorconst.py,sha256=6dzCQrZIhz7Drzmez7QVN8Q0JGgIqSABGdps6IMtC3U,3257
-gurobipy/_exception.cpython-310-darwin.so,sha256=YOSSh--SIsZ4BL49yYsKuVnHr1jm8Pnr01xoLfp5ZIk,162296
-gurobipy/_grb.py,sha256=0RVV4K0-z-2PDqAxmTiE65vKtsj2l34XGhJZKyw6v4A,7261
-gurobipy/_helpers.cpython-310-darwin.so,sha256=G4a-pz2RrYT3dWpi-zKdE0DSucVdVm0yQgZldZa3Gz8,162048
-gurobipy/_matrixapi.cpython-310-darwin.so,sha256=GQj1sQb_seRcaxjlKvGsAjp9Jc0unpImQCrIAK67b6A,3892408
-gurobipy/_model.cpython-310-darwin.so,sha256=brJcfqu1V_032tUjAdOtWb_ujg0_-IcLbM3bHITrz-M,3492000
-gurobipy/_modelutil.cpython-310-darwin.so,sha256=624UglbX4Fhz5RmagkZKLWYFOG3zGbs4HG-fP36nCZw,381800
-gurobipy/_paramconst.py,sha256=FJCm2d9JwaoelXv0P1zhtWeZGSmzS5ooM8zqvlXzBqc,19678
-gurobipy/_paramdetails.py,sha256=pzVMh5IGuzdI5o0iSoXy1yiV5KQupF7TmozAc3uKpL8,148362
-gurobipy/_statusconst.py,sha256=ZClEP0VXRsAWLzj5iVozzUgHfpfy4svJwFuY1DyNZN8,1601
-gurobipy/_tempconstr.cpython-310-darwin.so,sha256=6km2U3fFVfoM8rv59VzTiou0TdXVtfPMUWj1AK_H_f8,163192
-gurobipy/_tupledict.cpython-310-darwin.so,sha256=dk-Pit0BtOmGspYXvBR5YjwkjBCVae1wGc6Z4LSks9Q,382024
-gurobipy/_tuplelist.cpython-310-darwin.so,sha256=hqBYRndKgLmJJdTlfB0SU3QYAcwWt3cI8T3UByqfQBU,378776
-gurobipy/_util.cpython-310-darwin.so,sha256=yVfhMN7QmNylRow_hQieOa55VwzJAN9R4Hs59eF5Nss,282960
-gurobipy/nlfunc.cpython-310-darwin.so,sha256=NbDIFORXCQewcAlsRpwW5iCp_MSYQtt2VZULdul9zxw,217344
-gurobipy/nlfunc.pyi,sha256=ict_m30E7sNMQE852db8wxRQtkgadda54sS9HeObKBw,1178
-gurobipy/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-gurobipy/.libs/gurobi.lic,sha256=9xDz4iLWRWHiICr_Ify12Lmd0NIfhIeObN_YbVJawnM,90
-gurobipy/.libs/libgurobi120.dylib,sha256=l_pXCIz6ZQx4iMHMMqekFaQS10CaaY2l93kxEfauE48,15554544
-gurobipy-12.0.0b3.dist-info/LICENSE.txt,sha256=EJaZyhnM1ArhpFDQ9ZGJ_o5LEtwq5uRJga4dpxwMu7Q,156613
-gurobipy-12.0.0b3.dist-info/METADATA,sha256=c97h0ZxuKAmDsFmlfWENIpRZuAGo73k8j7utqaKCO0A,15700
-gurobipy-12.0.0b3.dist-info/WHEEL,sha256=_4-9bb7QIwAHvf_bVnSA8pF2cWt5z9quG49FBKitXRc,114
-gurobipy-12.0.0b3.dist-info/top_level.txt,sha256=lI8imVf2_cKV2kVT6NVXJ4sH0ib8oAKeh06ysN_0_Bg,9
-gurobipy-12.0.0b3.dist-info/RECORD,,