Merge pull request #730 from control-toolbox/uno

Integrate Uno solver and add solver requirements documentation

Author: ocots

CHANGELOG.md

@@ -7,6 +7,39 @@ Versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [1.3.1-beta] — 2026-03-17
+
+### Added
+
+- **Uno solver integration**: Full support for the Uno nonlinear optimization solver
+  - Added to solver registry with CPU-only support
+  - Added methods `(:collocation, :adnlp, :uno, :cpu)` and `(:collocation, :exa, :uno, :cpu)` to available methods
+  - Uno compatible with both ADNLP and Exa modelers
+  - Comprehensive test coverage with Beam and Goddard problems
+  - Extension error handling when `UnoSolver` package not loaded
+
+- **Solver requirements documentation**: Clear documentation of required imports for each solver
+  - New "Solver requirements" section in `manual-solve.md`
+  - Updated examples in `manual-solve-explicit.md` with import instructions
+  - GPU requirements clarification in `manual-solve-gpu.md`
+  - Based on CTSolvers extension triggers:
+    - Ipopt: `using NLPModelsIpopt`
+    - MadNLP: `using MadNLP` (CPU) or `using MadNLPGPU` (GPU)
+    - Uno: `using UnoSolver`
+    - MadNCL: `using MadNCL` and `using MadNLP`
+    - Knitro: `using NLPModelsKnitro` (commercial license)
+
+- **Solver output detection**: `will_solver_print(::CTSolvers.Uno)` method to check if Uno will produce output based on `logger` option (silent when `logger="SILENT"`)
+
+### Changed
+
+- **Solver count**: Updated from 4 to 5 available solvers (Ipopt, MadNLP, Uno, MadNCL, Knitro)
+- **Method count**: Updated from 10 to 12 available methods (10 CPU + 2 GPU)
+- **Test structure**: Restructured canonical tests to use modeler-solver pairs, Uno now works with both ADNLP and Exa
+- **Documentation**: Updated solver lists and examples throughout documentation to include Uno
+
+---
+
 ## [Unreleased] — branch `action-options`
 
 ### Added

Project.toml

@@ -1,6 +1,6 @@
 name = "OptimalControl"
 uuid = "5f98b655-cc9a-415a-b60e-744165666948"
-version = "1.3.0-beta"
+version = "1.3.2-beta"
 authors = ["Olivier Cots <olivier.cots@toulouse-inp.fr>"]
 
 [deps]
@@ -13,6 +13,7 @@ CTParser = "32681960-a1b1-40db-9bff-a1ca817385d1"
 CTSolvers = "d3e8d392-8e4b-4d9b-8e92-d7d4e3650ef6"
 CommonSolve = "38540f10-b2f7-11e9-35d8-d573e4eb0ff2"
 DocStringExtensions = "ffbed154-4ef7-542d-bbb7-c09d3a79fcae"
+Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
 ExaModels = "1037b233-b668-4ce9-9b63-f9f681f55dd2"
 LinearAlgebra = "37e2e46d-f89d-539d-b4ee-838fcccc9c8e"
 NLPModels = "a4795742-8479-5a88-8948-cc11e1c8c1a6"
@@ -33,6 +34,7 @@ CUDA = "5"
 CommonSolve = "0.2"
 DifferentiationInterface = "0.7"
 DocStringExtensions = "0.9"
+Documenter = "1.17.0"
 ExaModels = "0.9"
 ForwardDiff = "0.10, 1.0"
 LinearAlgebra = "1"
@@ -49,6 +51,7 @@ Reexport = "1"
 SolverCore = "0.3.9"
 SplitApplyCombine = "1"
 Test = "1"
+UnoSolver = "0.2"
 julia = "1.10"
 
 [extras]
@@ -66,6 +69,7 @@ OrdinaryDiffEq = "1dea7af3-3e70-54e6-95c3-0bf5283fa5ed"
 Printf = "de0858da-6303-5e67-8744-51eddeeeb8d7"
 SplitApplyCombine = "03a91e81-4c3e-53e1-a0a4-9c0c8f19dd66"
 Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40"
+UnoSolver = "1baa60ac-02f7-4b39-a7a8-2f4f58486b05"
 
 [targets]
-test = ["BenchmarkTools", "CUDA", "DifferentiationInterface", "ForwardDiff", "LinearAlgebra", "MadNCL", "MadNLP", "MadNLPGPU", "NLPModelsIpopt", "NonlinearSolve", "OrdinaryDiffEq", "Printf", "SplitApplyCombine", "Test"]
+test = ["BenchmarkTools", "CUDA", "DifferentiationInterface", "ForwardDiff", "LinearAlgebra", "MadNCL", "MadNLP", "MadNLPGPU", "NLPModelsIpopt", "NonlinearSolve", "OrdinaryDiffEq", "Printf", "SplitApplyCombine", "Test", "UnoSolver"]

docs/Project.toml

@@ -24,6 +24,7 @@ NLPModelsKnitro = "bec4dd0d-7755-52d5-9a02-22f0ffc7efcb"
 NonlinearSolve = "8913a72c-1f9b-4ce2-8d82-65094dcecaec"
 OrdinaryDiffEq = "1dea7af3-3e70-54e6-95c3-0bf5283fa5ed"
 Plots = "91a5bcdd-55d7-5caf-9e0b-520d859cae80"
+UnoSolver = "1baa60ac-02f7-4b39-a7a8-2f4f58486b05"
 
 [compat]
 ADNLPModels = "0.8"
@@ -51,4 +52,5 @@ NLPModelsKnitro = "0.10"
 NonlinearSolve = "4"
 OrdinaryDiffEq = "6"
 Plots = "1"
+UnoSolver = "0.2"
 julia = "1.10"

docs/doc.jl

@@ -233,4 +233,4 @@ with_api_reference(src_dir, ext_dir) do api_pages
 end
 
 # ═══════════════════════════════════════════════════════════════════════════════
-deploydocs(; repo=repo_url * ".git", devbranch="main")
+deploydocs(; repo=repo_url * ".git", devbranch="main", push_preview=true)