Opvious Python SDK
Project description
Opvious Python SDK
An SDK for solving linear, mixed-integer, and quadratic optimization models via the Opvious API.
Highlights
Declarative modeling API
- Extensive static validations
- Exportable to LaTeX
- Extensible support for high-level patterns (activation variables, masks, ...)
import opvious.modeling as om
class BinPacking(om.Model):
items = om.Dimension() # All items to bin
weight = om.Parameter.non_negative(items) # Weight per item
bins = om.interval(1, om.size(items), name="B") # Available bins
max_weight = om.Parameter.non_negative() # Maximum weight for each bin
assigned = om.Variable.indicator(bins, items) # Bin to item assignment
used = om.fragments.ActivationVariable(assigned, projection=1) # 1 if a bin is used
@om.constraint
def each_item_is_assigned_once(self):
for i in self.items:
yield om.total(self.assigned(b, i) for b in self.bins) == 1
@om.constraint
def bin_weights_are_below_max(self):
for b in self.bins:
bin_weight = om.total(self.weight(i) * self.assigned(b, i) for i in self.items)
yield bin_weight <= self.max_weight()
@om.objective
def minimize_bins_used(self):
return om.total(self.used(b) for b in self.bins)
Auto-generated specification:
Transparent remote solves
- No local solver installation required
- Real-time progress notifications
- Seamless data import/export via native support for
pandas
- Flexible multi-objective support: weighted sums, epsilon constraints, ...
- Built-in debugging capabilities: relaxations, fully annotated LP formatting, ...
import opvious
client = opvious.Client.default()
solution = await client.solve(
opvious.Problem(
specification=BinPacking().specification(),
parameters={
"weight": {"a": 10.5, "b": 22, "c": 48},
"binMaxWeight": 50,
},
),
)
assignments = solution.outputs.variable("assigned") # Optimal values
Take a look at https://opvious.readthedocs.io for the full documentation or these notebooks to see the SDK in action.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
opvious-0.18.2rc1.tar.gz
(122.0 kB
view hashes)
Built Distribution
Close
Hashes for opvious-0.18.2rc1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 39b3e0a9d8c09dbf2aff20f2b0e5be7bfb0f289b49beda510b83fbbba9efc15d |
|
MD5 | a8b03745d41bcc47e087d28edc60527e |
|
BLAKE2b-256 | fb66ae264b4afb189ad1ab6b3def080cdb0d2a698015d514dda86dc8c72d4558 |