Base class representing a constrained optimizer.
tf.contrib.constrained_optimization.ConstrainedOptimizer(
optimizer
)
A ConstrainedOptimizer wraps a tf.compat.v1.train.Optimizer (or more than
one), and applies it to a ConstrainedMinimizationProblem. Unlike a
tf.compat.v1.train.Optimizer, which takes a tensor to minimize as a parameter
to its minimize() method, a constrained optimizer instead takes a
ConstrainedMinimizationProblem.
Args |
optimizer
|
tf.compat.v1.train.Optimizer, used to optimize the
ConstraintedMinimizationProblem.
|
Methods
minimize
View source
minimize(
minimization_problem, unconstrained_steps=None, global_step=None, var_list=None,
gate_gradients=train_optimizer.Optimizer.GATE_OP, aggregation_method=None,
colocate_gradients_with_ops=False, name=None, grad_loss=None
)
Returns an Operation
for minimizing the constrained problem.
This method combines the functionality of minimize_unconstrained
and
minimize_constrained
. If global_step < unconstrained_steps, it will
perform an unconstrained update, and if global_step >= unconstrained_steps,
it will perform a constrained update.
The reason for this functionality is that it may be best to initialize the
constrained optimizer with an approximate optimum of the unconstrained
problem.
Returns |
Operation , the train_op.
|
Raises |
ValueError
|
If unconstrained_steps is provided, but global_step is not.
|
minimize_constrained
View source
minimize_constrained(
minimization_problem, global_step=None, var_list=None,
gate_gradients=train_optimizer.Optimizer.GATE_OP, aggregation_method=None,
colocate_gradients_with_ops=False, name=None, grad_loss=None
)
Returns an Operation
for minimizing the constrained problem.
Unlike minimize_unconstrained
, this function attempts to find a solution
that minimizes the objective
portion of the minimization problem while
satisfying the constraints
portion.
Returns |
Operation , the train_op.
|
minimize_unconstrained
View source
minimize_unconstrained(
minimization_problem, global_step=None, var_list=None,
gate_gradients=train_optimizer.Optimizer.GATE_OP, aggregation_method=None,
colocate_gradients_with_ops=False, name=None, grad_loss=None
)
Returns an Operation
for minimizing the unconstrained problem.
Unlike minimize_constrained
, this function ignores the constraints
(and
proxy_constraints
) portion of the minimization problem entirely, and only
minimizes objective
.
Returns |
Operation , the train_op.
|