solve_nlopt_proxy

compas_cem.optimization.solve_nlopt_proxy(topology, constraints, parameters, algorithm, iters, eps=None, tmax=100, eta=1e-06)[source]

Solve a constrained form-finding task through a Proxy server hyperspace tunnel.

Parameters:

  • topology (compas_cem.diagrams.TopologyDiagram) – A topology diagram.

  • constraints (list) – A list with the constraints to optimize for.

  • parameters (list) – A list of optimization parameters.

  • algorithm (str) – The name of the gradient-based local optimization algorithm to use. Only the following local gradient-based optimization algorithms are supported:

    • SLSQP: Sequential Least Squares Programming

    • LBFGS: Low-Storage Broyden-Fletcher-Goldfarb-Shanno

    • AUGLAG: Augmented Lagrangian

    • MMA: Method of Moving Asymptotes

    • TNEWTON: Preconditioned Truncated Newton

    Refer to the NLopt documentation for more details on their theoretical underpinnings.

  • iters (int) – The maximum number of iterations to run the optimization algorithm for.

  • eps (float) – The numerical convergence threshold for the optimization algorithm. If value is set to None, this parameter is ignored and the optimization algorithm will run until iters is exhausted. Defaults to None.

  • tmax (int, optional) – The maximum number of iterations the CEM form-finding algorithm will run for. If eta is hit first, the form-finding algorithm will stop early. Defaults to 100.

  • eta (float, optional) – The numerical converge threshold of the CEM form-finding algorithm. If tmax is hit first, the form-finding algorithm will stop early. Defaults to 1e-6.

Returns:

  • form (compas_cem.diagrams.FormDiagram) – A form diagram.

  • objective (float) – The final value of the objective function.

  • grad_norm (float) – The cummulative norm of the gradients.

  • iters (int) – The elapsed number of iterations.

  • duration (float) – The total optimization time in milliseconds.

  • status (str) – The final status of the optimization problem as per NLOpt.