Safe Haskell	Safe
Language	Haskell2010

Math.Programming

Contents

Math programs
- Linear programs
- Integer programs
Model-building DSL

Description

A library for modeling and solving linear and integer programs.

This library is merely a frontend to various solver backends. At the time this was written, the only known supported backend is GLPK.

Synopsis

class (Monad m, Num (Numeric m)) => LPMonad m where
- type Numeric m :: *
- data Variable m :: *
- data Constraint m :: *
- data Objective m :: *
- addVariable :: m (Variable m)
- removeVariable :: Variable m -> m ()
- getVariableName :: Variable m -> m String
- setVariableName :: Variable m -> String -> m ()
- getVariableBounds :: Variable m -> m (Bounds (Numeric m))
- setVariableBounds :: Variable m -> Bounds (Numeric m) -> m ()
- getVariableValue :: Variable m -> m (Numeric m)
- addConstraint :: Inequality (LinearExpression (Numeric m) (Variable m)) -> m (Constraint m)
- removeConstraint :: Constraint m -> m ()
- getConstraintName :: Constraint m -> m String
- setConstraintName :: Constraint m -> String -> m ()
- getDualValue :: Constraint m -> m (Numeric m)
- addObjective :: LinearExpression (Numeric m) (Variable m) -> m (Objective m)
- getObjectiveName :: Objective m -> m String
- setObjectiveName :: Objective m -> String -> m ()
- getObjectiveSense :: Objective m -> m Sense
- setObjectiveSense :: Objective m -> Sense -> m ()
- getObjectiveValue :: Objective m -> m (Numeric m)
- getTimeout :: m Double
- setTimeout :: Double -> m ()
- optimizeLP :: m SolutionStatus
- writeFormulation :: FilePath -> m ()
type Expr m = LinearExpression (Numeric m) (Variable m)
data Bounds b
- = NonNegativeReals
- | NonPositiveReals
- | Interval b b
- | Free
data SolutionStatus
- = Optimal
- | Feasible
- | Infeasible
- | Unbounded
- | Error
data Sense
- = Minimization
- | Maximization
class LPMonad m => IPMonad m where
- optimizeIP :: m SolutionStatus
- getVariableDomain :: Variable m -> m Domain
- setVariableDomain :: Variable m -> Domain -> m ()
- getRelativeMIPGap :: m Double
- setRelativeMIPGap :: Double -> m ()
data Domain
- = Continuous
- | Integer
- | Binary
free :: LPMonad m => m (Variable m)
nonNeg :: LPMonad m => m (Variable m)
nonPos :: LPMonad m => m (Variable m)
bounded :: LPMonad m => Numeric m -> Numeric m -> m (Variable m)
within :: LPMonad m => m (Variable m) -> Bounds (Numeric m) -> m (Variable m)
integer :: IPMonad m => m (Variable m)
binary :: IPMonad m => m (Variable m)
nonNegInteger :: IPMonad m => m (Variable m)
nonPosInteger :: IPMonad m => m (Variable m)
asKind :: IPMonad m => m (Variable m) -> Domain -> m (Variable m)
data LinearExpression a b = LinearExpression [(a, b)] a
eval :: Num a => LinearExpression a a -> a
simplify :: (Ord b, Num a) => LinearExpression a b -> LinearExpression a b
var :: Num a => b -> LinearExpression a b
con :: Num a => a -> LinearExpression a b
exprSum :: Num a => [LinearExpression a b] -> LinearExpression a b
varSum :: Num a => [b] -> LinearExpression a b
(.+.) :: Num a => LinearExpression a b -> LinearExpression a b -> LinearExpression a b
(@+@) :: Num a => b -> b -> LinearExpression a b
(.+@) :: Num a => LinearExpression a b -> b -> LinearExpression a b
(@+.) :: Num a => b -> LinearExpression a b -> LinearExpression a b
(@+#) :: Num a => b -> a -> LinearExpression a b
(#+@) :: Num a => a -> b -> LinearExpression a b
(#+.) :: Num a => a -> LinearExpression a b -> LinearExpression a b
(.+#) :: Num a => LinearExpression a b -> a -> LinearExpression a b
(.-.) :: Num a => LinearExpression a b -> LinearExpression a b -> LinearExpression a b
(@-@) :: Num a => b -> b -> LinearExpression a b
(.-@) :: Num a => LinearExpression a b -> b -> LinearExpression a b
(@-.) :: Num a => b -> LinearExpression a b -> LinearExpression a b
(@-#) :: Num a => b -> a -> LinearExpression a b
(#-@) :: Num a => a -> b -> LinearExpression a b
(#-.) :: Num a => a -> LinearExpression a b -> LinearExpression a b
(.-#) :: Num a => LinearExpression a b -> a -> LinearExpression a b
(#*@) :: Num a => a -> b -> LinearExpression a b
(@*#) :: Num a => b -> a -> LinearExpression a b
(#*.) :: Num a => a -> LinearExpression a b -> LinearExpression a b
(.*#) :: Num a => LinearExpression a b -> a -> LinearExpression a b
(@/#) :: Fractional a => b -> a -> LinearExpression a b
(./#) :: Fractional a => LinearExpression a b -> a -> LinearExpression a b
data Inequality a = Inequality Ordering a a
(#<=@) :: LPMonad m => Numeric m -> Variable m -> m (Constraint m)
(#<=.) :: LPMonad m => Numeric m -> Expr m -> m (Constraint m)
(@<=#) :: LPMonad m => Variable m -> Numeric m -> m (Constraint m)
(@<=@) :: LPMonad m => Variable m -> Variable m -> m (Constraint m)
(@<=.) :: LPMonad m => Variable m -> Expr m -> m (Constraint m)
(.<=#) :: LPMonad m => Expr m -> Numeric m -> m (Constraint m)
(.<=@) :: LPMonad m => Expr m -> Variable m -> m (Constraint m)
(.<=.) :: LPMonad m => Expr m -> Expr m -> m (Constraint m)
(#>=@) :: LPMonad m => Numeric m -> Variable m -> m (Constraint m)
(#>=.) :: LPMonad m => Numeric m -> Expr m -> m (Constraint m)
(@>=#) :: LPMonad m => Variable m -> Numeric m -> m (Constraint m)
(@>=@) :: LPMonad m => Variable m -> Variable m -> m (Constraint m)
(@>=.) :: LPMonad m => Variable m -> Expr m -> m (Constraint m)
(.>=#) :: LPMonad m => Expr m -> Numeric m -> m (Constraint m)
(.>=@) :: LPMonad m => Expr m -> Variable m -> m (Constraint m)
(.>=.) :: LPMonad m => Expr m -> Expr m -> m (Constraint m)
(#==@) :: LPMonad m => Numeric m -> Variable m -> m (Constraint m)
(#==.) :: LPMonad m => Numeric m -> Expr m -> m (Constraint m)
(@==#) :: LPMonad m => Variable m -> Numeric m -> m (Constraint m)
(@==@) :: LPMonad m => Variable m -> Variable m -> m (Constraint m)
(@==.) :: LPMonad m => Variable m -> Expr m -> m (Constraint m)
(.==#) :: LPMonad m => Expr m -> Numeric m -> m (Constraint m)
(.==@) :: LPMonad m => Expr m -> Variable m -> m (Constraint m)
(.==.) :: LPMonad m => Expr m -> Expr m -> m (Constraint m)
minimize :: LPMonad m => Expr m -> m (Objective m)
maximize :: LPMonad m => Expr m -> m (Objective m)
evalExpr :: LPMonad m => Expr m -> m (Numeric m)
named :: (Monad m, Nameable m a) => m a -> String -> m a
nameOf :: (Monad m, Nameable m a) => a -> m String

Math programs

The LPMonad provides all the primitives necessary to formulate and solve linear programs; the IPMonad provides the same for integer programs. However, you should not often need to use these APIs directly, as we provide more user-friendly functions wrapping these low-level functions below.

Linear programs

class (Monad m, Num (Numeric m)) => LPMonad m where Source #

A monad for formulating and solving linear programs.

We manipulate linear programs and their settings using the Mutable typeclass.

Associated Types

type Numeric m :: * Source #

The numeric type used in the model.

data Variable m :: * Source #

The type of variables in the model. LPMonad treats these as opaque values, but instances may expose more details.

data Constraint m :: * Source #

The type of constraints in the model. LPMonad treats these as opaque values, but instances may expose more details.

data Objective m :: * Source #

The type of objectives in the model. LPMonad treats these as opaque values, but instances may expose more details.

Methods

addVariable :: m (Variable m) Source #

Create a new decision variable in the model.

This variable will be initialized to be a non-negative continuous variable.

removeVariable :: Variable m -> m () Source #

Remove a decision variable from the model.

The variable cannot be used after being deleted.

getVariableName :: Variable m -> m String Source #

Get the name of the variable.

setVariableName :: Variable m -> String -> m () Source #

Set the name of the variable.

getVariableBounds :: Variable m -> m (Bounds (Numeric m)) Source #

Get the allowed values of a variable.

setVariableBounds :: Variable m -> Bounds (Numeric m) -> m () Source #

Constrain a variable to take on certain values.

getVariableValue :: Variable m -> m (Numeric m) Source #

Get the value of a variable in the current solution.

addConstraint :: Inequality (LinearExpression (Numeric m) (Variable m)) -> m (Constraint m) Source #

Add a constraint to the model represented by an inequality.

removeConstraint :: Constraint m -> m () Source #

Remove a constraint from the model.

The constraint cannot used after being deleted.

getConstraintName :: Constraint m -> m String Source #

Get the name of the constraint.

setConstraintName :: Constraint m -> String -> m () Source #

Set the name of the constraint.

getDualValue :: Constraint m -> m (Numeric m) Source #

Get the value of the dual variable associated with the constraint in the current solution.

This value has no meaning if the current solution is not an LP solution.

addObjective :: LinearExpression (Numeric m) (Variable m) -> m (Objective m) Source #

Add a constraint to the model represented by an inequality.

getObjectiveName :: Objective m -> m String Source #

Get the name of the objective.

setObjectiveName :: Objective m -> String -> m () Source #

Set the name of the objective.

getObjectiveSense :: Objective m -> m Sense Source #

Whether the objective is to be minimized or maximized.

setObjectiveSense :: Objective m -> Sense -> m () Source #

Set whether the objective is to be minimized or maximized.

getObjectiveValue :: Objective m -> m (Numeric m) Source #

Get the value of the objective in the current solution.

getTimeout :: m Double Source #

Get the number of seconds the solver is allowed to run before halting.

setTimeout :: Double -> m () Source #

Set the number of seconds the solver is allowed to run before halting.

optimizeLP :: m SolutionStatus Source #

Optimize the continuous relaxation of the model.

writeFormulation :: FilePath -> m () Source #

Write out the formulation.

type Expr m = LinearExpression (Numeric m) (Variable m) Source #

A convient shorthand for the type of linear expressions used in a given model.

data Bounds b Source #

An interval of the real numbers.

Constructors

NonNegativeReals	The non-negative reals.
NonPositiveReals	The non-positive reals.
Interval b b	Any closed interval of the reals.
Free	Any real number.

Instances

Read b => Read (Bounds b) Source #
Instance details Defined in Math.Programming.Types Methods readsPrec :: Int -> ReadS (Bounds b) # readList :: ReadS [Bounds b] # readPrec :: ReadPrec (Bounds b) # readListPrec :: ReadPrec [Bounds b] #
Show b => Show (Bounds b) Source #
Instance details Defined in Math.Programming.Types Methods showsPrec :: Int -> Bounds b -> ShowS # show :: Bounds b -> String # showList :: [Bounds b] -> ShowS #

data SolutionStatus Source #

The outcome of an optimization.

Constructors

Optimal	An optimal solution has been found.
Feasible	A feasible solution has been found. The result may or may not be optimal.
Infeasible	The model has been proven to be infeasible.
Unbounded	The model has been proven to be unbounded.
Error	An error was encountered during the solve. Instance-specific methods should be used to determine what occurred.

Instances

Eq SolutionStatus Source #
Instance details Defined in Math.Programming.Types Methods (==) :: SolutionStatus -> SolutionStatus -> Bool # (/=) :: SolutionStatus -> SolutionStatus -> Bool #
Ord SolutionStatus Source #
Instance details Defined in Math.Programming.Types Methods compare :: SolutionStatus -> SolutionStatus -> Ordering # (<) :: SolutionStatus -> SolutionStatus -> Bool # (<=) :: SolutionStatus -> SolutionStatus -> Bool # (>) :: SolutionStatus -> SolutionStatus -> Bool # (>=) :: SolutionStatus -> SolutionStatus -> Bool # max :: SolutionStatus -> SolutionStatus -> SolutionStatus # min :: SolutionStatus -> SolutionStatus -> SolutionStatus #
Read SolutionStatus Source #
Instance details Defined in Math.Programming.Types Methods readsPrec :: Int -> ReadS SolutionStatus # readList :: ReadS [SolutionStatus] # readPrec :: ReadPrec SolutionStatus # readListPrec :: ReadPrec [SolutionStatus] #
Show SolutionStatus Source #
Instance details Defined in Math.Programming.Types Methods showsPrec :: Int -> SolutionStatus -> ShowS # show :: SolutionStatus -> String # showList :: [SolutionStatus] -> ShowS #

data Sense Source #

Whether a math program is minimizing or maximizing its objective.

Constructors

Minimization
Maximization

Instances

Eq Sense Source #
Instance details Defined in Math.Programming.Types Methods (==) :: Sense -> Sense -> Bool # (/=) :: Sense -> Sense -> Bool #
Ord Sense Source #
Instance details Defined in Math.Programming.Types Methods compare :: Sense -> Sense -> Ordering # (<) :: Sense -> Sense -> Bool # (<=) :: Sense -> Sense -> Bool # (>) :: Sense -> Sense -> Bool # (>=) :: Sense -> Sense -> Bool # max :: Sense -> Sense -> Sense # min :: Sense -> Sense -> Sense #
Read Sense Source #
Instance details Defined in Math.Programming.Types Methods readsPrec :: Int -> ReadS Sense # readList :: ReadS [Sense] # readPrec :: ReadPrec Sense # readListPrec :: ReadPrec [Sense] #
Show Sense Source #
Instance details Defined in Math.Programming.Types Methods showsPrec :: Int -> Sense -> ShowS # show :: Sense -> String # showList :: [Sense] -> ShowS #

Integer programs

class LPMonad m => IPMonad m where Source #

A (mixed) integer program.

In addition to the methods of the LPMonad class, this monad supports constraining variables to be either continuous or discrete.

Methods

optimizeIP :: m SolutionStatus Source #

Optimize the mixed-integer program.

getVariableDomain :: Variable m -> m Domain Source #

Get the domain of a variable.

setVariableDomain :: Variable m -> Domain -> m () Source #

Set the domain of a variable.

getRelativeMIPGap :: m Double Source #

Get the allowed relative gap between LP and IP solutions.

setRelativeMIPGap :: Double -> m () Source #

Set the allowed relative gap between LP and IP solutions.

data Domain Source #

The type of values that a variable can take on.

Note that the Integer constructor does not interfere with the Integer type, as the Integer type does not define a constuctor of the same name. The ambiguity is unfortunate, but other natural nomenclature such as Integral are similarly conflicted.

Constructors

Continuous	The variable lies in the real numbers
Integer	The variable lies in the integers
Binary	The variable lies in the set `{0, 1}`.

Instances

Read Domain Source #
Instance details Defined in Math.Programming.Types Methods readsPrec :: Int -> ReadS Domain # readList :: ReadS [Domain] # readPrec :: ReadPrec Domain # readListPrec :: ReadPrec [Domain] #
Show Domain Source #
Instance details Defined in Math.Programming.Types Methods showsPrec :: Int -> Domain -> ShowS # show :: Domain -> String # showList :: [Domain] -> ShowS #

Model-building DSL

The functions in the LPMonad and IPMonad typeclasses are designed to interface with low-level solver backends. We provide a cleaner interface in the following sections.

Creating variables

LPMonad provides addVariable and setVariableBounds, and IPMonad additionally provides setVariableDomain. While sufficient to create your programs, you are encouraged to use the more natural functions below.

Continuous variables

free :: LPMonad m => m (Variable m) Source #

Create a new free variable.

nonNeg :: LPMonad m => m (Variable m) Source #

Create a new non-negative variable.

nonPos :: LPMonad m => m (Variable m) Source #

Create a new non-positive variable.

bounded :: LPMonad m => Numeric m -> Numeric m -> m (Variable m) Source #

Create a new variable bounded between two values.

within :: LPMonad m => m (Variable m) -> Bounds (Numeric m) -> m (Variable m) Source #

Constrain a variable to take on certain values.

This function is designed to be used as an infix operator, e.g.

addVariable `within` NonNegativeReals

Integer variables

integer :: IPMonad m => m (Variable m) Source #

Create an integer-valued variable.

binary :: IPMonad m => m (Variable m) Source #

Create a binary variable.

nonNegInteger :: IPMonad m => m (Variable m) Source #

Create an integer-value variable that takes on non-negative values.

nonPosInteger :: IPMonad m => m (Variable m) Source #

Create an integer-value variable that takes on non-positive values.

asKind :: IPMonad m => m (Variable m) -> Domain -> m (Variable m) Source #

Set the type of a variable.

This function is designed to be used as an infix operator, e.g.

addVariable `asKind` Binary

Linear expressions

The module LinearExpression provides operators to build up LinearExpression objects using declared variables.

data LinearExpression a b Source #

A linear expression containing symbolic variables of type b and numeric coefficients of type a.

Using Strings to denote variables and Doubles as our numeric type, we could express 3 x + 2 y + 1 as

  LinearExpression [(3, "x"), (2, "y")] 1

Constructors

LinearExpression [(a, b)] a

Instances

Bifunctor LinearExpression Source #
Instance details Defined in Math.Programming.Types Methods bimap :: (a -> b) -> (c -> d) -> LinearExpression a c -> LinearExpression b d # first :: (a -> b) -> LinearExpression a c -> LinearExpression b c # second :: (b -> c) -> LinearExpression a b -> LinearExpression a c #
Functor (LinearExpression a) Source #
Instance details Defined in Math.Programming.Types Methods fmap :: (a0 -> b) -> LinearExpression a a0 -> LinearExpression a b # (<$) :: a0 -> LinearExpression a b -> LinearExpression a a0 #
Foldable (LinearExpression a) Source #
Instance details Defined in Math.Programming.Types Methods fold :: Monoid m => LinearExpression a m -> m # foldMap :: Monoid m => (a0 -> m) -> LinearExpression a a0 -> m # foldr :: (a0 -> b -> b) -> b -> LinearExpression a a0 -> b # foldr' :: (a0 -> b -> b) -> b -> LinearExpression a a0 -> b # foldl :: (b -> a0 -> b) -> b -> LinearExpression a a0 -> b # foldl' :: (b -> a0 -> b) -> b -> LinearExpression a a0 -> b # foldr1 :: (a0 -> a0 -> a0) -> LinearExpression a a0 -> a0 # foldl1 :: (a0 -> a0 -> a0) -> LinearExpression a a0 -> a0 # toList :: LinearExpression a a0 -> [a0] # null :: LinearExpression a a0 -> Bool # length :: LinearExpression a a0 -> Int # elem :: Eq a0 => a0 -> LinearExpression a a0 -> Bool # maximum :: Ord a0 => LinearExpression a a0 -> a0 # minimum :: Ord a0 => LinearExpression a a0 -> a0 # sum :: Num a0 => LinearExpression a a0 -> a0 # product :: Num a0 => LinearExpression a a0 -> a0 #
Traversable (LinearExpression a) Source #	Useful for substituting values in a monadic/applicative context
Instance details Defined in Math.Programming.Types Methods traverse :: Applicative f => (a0 -> f b) -> LinearExpression a a0 -> f (LinearExpression a b) # sequenceA :: Applicative f => LinearExpression a (f a0) -> f (LinearExpression a a0) # mapM :: Monad m => (a0 -> m b) -> LinearExpression a a0 -> m (LinearExpression a b) # sequence :: Monad m => LinearExpression a (m a0) -> m (LinearExpression a a0) #
(Read a, Read b) => Read (LinearExpression a b) Source #
Instance details Defined in Math.Programming.Types Methods readsPrec :: Int -> ReadS (LinearExpression a b) # readList :: ReadS [LinearExpression a b] # readPrec :: ReadPrec (LinearExpression a b) # readListPrec :: ReadPrec [LinearExpression a b] #
(Show a, Show b) => Show (LinearExpression a b) Source #
Instance details Defined in Math.Programming.Types Methods showsPrec :: Int -> LinearExpression a b -> ShowS # show :: LinearExpression a b -> String # showList :: [LinearExpression a b] -> ShowS #
Num a => Semigroup (LinearExpression a b) Source #	Implements addition of 'LinearExpression a b' terms
Instance details Defined in Math.Programming.Types Methods (<>) :: LinearExpression a b -> LinearExpression a b -> LinearExpression a b # sconcat :: NonEmpty (LinearExpression a b) -> LinearExpression a b # stimes :: Integral b0 => b0 -> LinearExpression a b -> LinearExpression a b #
Num a => Monoid (LinearExpression a b) Source #	Using '0' as the identity element
Instance details Defined in Math.Programming.Types Methods mempty :: LinearExpression a b # mappend :: LinearExpression a b -> LinearExpression a b -> LinearExpression a b # mconcat :: [LinearExpression a b] -> LinearExpression a b #

eval :: Num a => LinearExpression a a -> a Source #

Reduce an expression to its value.

simplify :: (Ord b, Num a) => LinearExpression a b -> LinearExpression a b Source #

Combine equivalent terms by summing their coefficients.

var :: Num a => b -> LinearExpression a b Source #

Construct an expression representing a variable.

con :: Num a => a -> LinearExpression a b Source #

Construct an expression representing a constant.

exprSum :: Num a => [LinearExpression a b] -> LinearExpression a b Source #

Construct an expression by summing expressions.

varSum :: Num a => [b] -> LinearExpression a b Source #

Construct an expression by summing variables.

Addition

We can summarize the addition operators with the table

	Constant	Variable	Expression
Constant	`+`	`#+@`	`#+.`
Variable	`@+#`	`@+@`	`@+.`
Expression	`.+#`	`.+@`	`.+.`

(.+.) :: Num a => LinearExpression a b -> LinearExpression a b -> LinearExpression a b infixl 6 Source #

(@+@) :: Num a => b -> b -> LinearExpression a b infixl 6 Source #

(.+@) :: Num a => LinearExpression a b -> b -> LinearExpression a b infixl 6 Source #

(@+.) :: Num a => b -> LinearExpression a b -> LinearExpression a b infixl 6 Source #

(@+#) :: Num a => b -> a -> LinearExpression a b infixl 6 Source #

(#+@) :: Num a => a -> b -> LinearExpression a b infixl 6 Source #

(#+.) :: Num a => a -> LinearExpression a b -> LinearExpression a b infixl 6 Source #

(.+#) :: Num a => LinearExpression a b -> a -> LinearExpression a b infixl 6 Source #

Subtraction

We can summarize the subtraction operators with the table

	Constant	Variable	Expression
Constant	`-`	`#-@`	`#-.`
Variable	`@-#`	`@-@`	`@-.`
Expression	`.-#`	`.-@`	`.-.`

(.-.) :: Num a => LinearExpression a b -> LinearExpression a b -> LinearExpression a b infixl 6 Source #

(@-@) :: Num a => b -> b -> LinearExpression a b infixl 6 Source #

(.-@) :: Num a => LinearExpression a b -> b -> LinearExpression a b infixl 6 Source #

(@-.) :: Num a => b -> LinearExpression a b -> LinearExpression a b infixl 6 Source #

(@-#) :: Num a => b -> a -> LinearExpression a b infixl 6 Source #

(#-@) :: Num a => a -> b -> LinearExpression a b infixl 6 Source #

(#-.) :: Num a => a -> LinearExpression a b -> LinearExpression a b infixl 6 Source #

(.-#) :: Num a => LinearExpression a b -> a -> LinearExpression a b infixl 6 Source #

Multiplication

We can summarize the multiplication operators with the table

	Constant	Variable	Expression
Constant	`*`	`#*@`	`#*.`
Variable	`@*#`
Expression	`.*#`

As there are few possibilities for valid multiplication, it can be convenient to define e.g. .* or some other short operator as an alias for #*@.

(#*@) :: Num a => a -> b -> LinearExpression a b infixl 7 Source #

(@*#) :: Num a => b -> a -> LinearExpression a b infixl 7 Source #

(#*.) :: Num a => a -> LinearExpression a b -> LinearExpression a b infixl 7 Source #

(.*#) :: Num a => LinearExpression a b -> a -> LinearExpression a b infixl 7 Source #

Division

We can summarize the multiplication operators with the table

	Constant	Variable	Expression
Constant	`/`
Variable	`@/#`
Expression	`./#`

As there are few possibilities for valid division, it can be convenient to define e.g. ./ or some other short operator as an alias for @/#.

(@/#) :: Fractional a => b -> a -> LinearExpression a b infixl 7 Source #

(./#) :: Fractional a => LinearExpression a b -> a -> LinearExpression a b infixl 7 Source #

Constraints

The LPMonad provides the addConstraint function. However, you will typically use the operators below to directly apply constraints to the model. We follow the same conventions as with our arithmetic operators.

data Inequality a Source #

Non-strict inequalities.

Constructors

Inequality Ordering a a

Instances

Functor Inequality Source #
Instance details Defined in Math.Programming.Types Methods fmap :: (a -> b) -> Inequality a -> Inequality b # (<$) :: a -> Inequality b -> Inequality a #
Foldable Inequality Source #
Instance details Defined in Math.Programming.Types Methods fold :: Monoid m => Inequality m -> m # foldMap :: Monoid m => (a -> m) -> Inequality a -> m # foldr :: (a -> b -> b) -> b -> Inequality a -> b # foldr' :: (a -> b -> b) -> b -> Inequality a -> b # foldl :: (b -> a -> b) -> b -> Inequality a -> b # foldl' :: (b -> a -> b) -> b -> Inequality a -> b # foldr1 :: (a -> a -> a) -> Inequality a -> a # foldl1 :: (a -> a -> a) -> Inequality a -> a # toList :: Inequality a -> [a] # null :: Inequality a -> Bool # length :: Inequality a -> Int # elem :: Eq a => a -> Inequality a -> Bool # maximum :: Ord a => Inequality a -> a # minimum :: Ord a => Inequality a -> a # sum :: Num a => Inequality a -> a # product :: Num a => Inequality a -> a #
Traversable Inequality Source #
Instance details Defined in Math.Programming.Types Methods traverse :: Applicative f => (a -> f b) -> Inequality a -> f (Inequality b) # sequenceA :: Applicative f => Inequality (f a) -> f (Inequality a) # mapM :: Monad m => (a -> m b) -> Inequality a -> m (Inequality b) # sequence :: Monad m => Inequality (m a) -> m (Inequality a) #
Read a => Read (Inequality a) Source #
Instance details Defined in Math.Programming.Types Methods readsPrec :: Int -> ReadS (Inequality a) # readList :: ReadS [Inequality a] # readPrec :: ReadPrec (Inequality a) # readListPrec :: ReadPrec [Inequality a] #
Show a => Show (Inequality a) Source #
Instance details Defined in Math.Programming.Types Methods showsPrec :: Int -> Inequality a -> ShowS # show :: Inequality a -> String # showList :: [Inequality a] -> ShowS #

Less-than constraints

We can summarize the various inquality operators in the following table.

	Constant	Variable	Expression
Constant		`#<=@`	`#<=.`
Variable	`@<=#`	`@<=@`	`@<=.`
Expression	`.<=#`	`.<=@`	`.<=.`

(#<=@) :: LPMonad m => Numeric m -> Variable m -> m (Constraint m) infix 4 Source #

(#<=.) :: LPMonad m => Numeric m -> Expr m -> m (Constraint m) infix 4 Source #

(@<=#) :: LPMonad m => Variable m -> Numeric m -> m (Constraint m) infix 4 Source #

(@<=@) :: LPMonad m => Variable m -> Variable m -> m (Constraint m) infix 4 Source #

(@<=.) :: LPMonad m => Variable m -> Expr m -> m (Constraint m) infix 4 Source #

(.<=#) :: LPMonad m => Expr m -> Numeric m -> m (Constraint m) infix 4 Source #

(.<=@) :: LPMonad m => Expr m -> Variable m -> m (Constraint m) infix 4 Source #

(.<=.) :: LPMonad m => Expr m -> Expr m -> m (Constraint m) infix 4 Source #

Greater-than constraints

We can summarize the various inquality operators in the following table.

	Constant	Variable	Expression
Constant		`#>=@`	`#>=.`
Variable	`@>=#`	`@>=@`	`@>=.`
Expression	`.>=#`	`.>=@`	`.>=.`

(#>=@) :: LPMonad m => Numeric m -> Variable m -> m (Constraint m) infix 4 Source #

(#>=.) :: LPMonad m => Numeric m -> Expr m -> m (Constraint m) infix 4 Source #

(@>=#) :: LPMonad m => Variable m -> Numeric m -> m (Constraint m) infix 4 Source #

(@>=@) :: LPMonad m => Variable m -> Variable m -> m (Constraint m) infix 4 Source #

(@>=.) :: LPMonad m => Variable m -> Expr m -> m (Constraint m) infix 4 Source #

(.>=#) :: LPMonad m => Expr m -> Numeric m -> m (Constraint m) infix 4 Source #

(.>=@) :: LPMonad m => Expr m -> Variable m -> m (Constraint m) infix 4 Source #

(.>=.) :: LPMonad m => Expr m -> Expr m -> m (Constraint m) infix 4 Source #

Equality constraints

We can summarize the various inquality operators in the following table.

	Constant	Variable	Expression
Constant		`#==@`	`#==.`
Variable	`@==#`	`@==@`	`@==.`
Expression	`.==#`	`.==@`	`.==.`

(#==@) :: LPMonad m => Numeric m -> Variable m -> m (Constraint m) infix 4 Source #

(#==.) :: LPMonad m => Numeric m -> Expr m -> m (Constraint m) infix 4 Source #

(@==#) :: LPMonad m => Variable m -> Numeric m -> m (Constraint m) infix 4 Source #

(@==@) :: LPMonad m => Variable m -> Variable m -> m (Constraint m) infix 4 Source #

(@==.) :: LPMonad m => Variable m -> Expr m -> m (Constraint m) infix 4 Source #

(.==#) :: LPMonad m => Expr m -> Numeric m -> m (Constraint m) infix 4 Source #

(.==@) :: LPMonad m => Expr m -> Variable m -> m (Constraint m) infix 4 Source #

(.==.) :: LPMonad m => Expr m -> Expr m -> m (Constraint m) infix 4 Source #

Specifying objectives

minimize :: LPMonad m => Expr m -> m (Objective m) Source #

Create an objective to be minimized.

maximize :: LPMonad m => Expr m -> m (Objective m) Source #

Create an objective to be maximized.

Utilities

evalExpr :: LPMonad m => Expr m -> m (Numeric m) Source #

Get the value of a linear expression in the current solution.

named :: (Monad m, Nameable m a) => m a -> String -> m a Source #

Name a variable, constraint, or objective.

This function is designed to be used as an infix operator, e.g.

free `named` X_1

nameOf :: (Monad m, Nameable m a) => a -> m String Source #

Retrieve the name of a variable, constraint, or objective.