Options¶
CompileOptions ¶
Bases: NamedTuple
Options of turning the functions of a problem into programs.
disk_cache
class-attribute
instance-attribute
¶
Whether lowered programs and executables are stored in the cache directory.
The directory is CYXLA_CACHE_DIR if set, and ~/.cache/cyxla otherwise.
zero_copy
class-attribute
instance-attribute
¶
Whether executions read and write host memory directly when the plugin allows it.
Hessian ¶
Bases: Enum
How Ipopt gets second derivatives.
Derivatives ¶
Bases: Enum
How the Jacobian and the Hessian are computed, and where their patterns come from.
AUTOMATIC
class-attribute
instance-attribute
¶
asdex when it is installed, and dense derivatives with a warning when it is not.
SPARSE
class-attribute
instance-attribute
¶
asdex detects the patterns, colors them and evaluates the compressed derivatives.
A pattern that a problem gives replaces the detected one.
DENSE
class-attribute
instance-attribute
¶
JAX differentiates densely and the programs keep the entries of the pattern.
A problem without patterns gets all entries, and asdex is not needed.
SolveOptions ¶
Bases: NamedTuple
Limits and settings of one solve.
tolerance
class-attribute
instance-attribute
¶
Ipopt's tol, the tolerance on the scaled optimality error.
time_limit
class-attribute
instance-attribute
¶
Seconds of wall time after which Ipopt stops, or None for no limit.
print_level
class-attribute
instance-attribute
¶
Ipopt's print_level from 0, which prints nothing, to 12.
blas_threads
class-attribute
instance-attribute
¶
Threads of OpenBLAS, or None to leave the setting as it is.
One thread suits the sparse factorizations of problems that fit in a few million entries, since the linear algebra calls are small.
settings
class-attribute
instance-attribute
¶
Further option values, applied after the fields above.
callback
class-attribute
instance-attribute
¶
A function called at the end of every iteration, or None.
Ipopt stops with Status.USER_REQUESTED_STOP when it returns False. Returning
nothing continues. The function runs with the GIL, so it slows a solve down.
IpoptSetting ¶
Bases: NamedTuple
A value for one Ipopt option.
LinearSolver ¶
Bases: Enum
The sparse linear solvers that the Ipopt library of the wheel contains.