|
1 |
| -# GalacticOptim.jl |
| 1 | +# Optimization.jl |
2 | 2 |
|
3 |
| -[](https://github.com/SciML/GalacticOptim.jl/actions?query=workflow%3ACI) |
4 |
| -[](http://galacticoptim.sciml.ai/stable/) |
5 |
| -[](http://galacticoptim.sciml.ai/dev/) |
| 3 | +[](https://github.com/SciML/Optimization.jl/actions?query=workflow%3ACI) |
| 4 | +[](http://Optimization.sciml.ai/stable/) |
| 5 | +[](http://Optimization.sciml.ai/dev/) |
6 | 6 |
|
7 |
| -GalacticOptim.jl is a package with a scope that is beyond your normal global optimization |
8 |
| -package. GalacticOptim.jl seeks to bring together all of the optimization packages |
| 7 | +Optimization.jl is a package with a scope that is beyond your normal global optimization |
| 8 | +package. Optimization.jl seeks to bring together all of the optimization packages |
9 | 9 | it can find, local and global, into one unified Julia interface. This means, you
|
10 |
| -learn one package and you learn them all! GalacticOptim.jl adds a few high-level |
| 10 | +learn one package and you learn them all! Optimization.jl adds a few high-level |
11 | 11 | features, such as integrating with automatic differentiation, to make its usage
|
12 | 12 | fairly simple for most cases, while allowing all of the options in a single
|
13 | 13 | unified interface.
|
14 | 14 |
|
15 | 15 | ## Installation
|
16 | 16 |
|
17 | 17 | Assuming that you already have Julia correctly installed, it suffices to import
|
18 |
| -GalacticOptim.jl in the standard way: |
| 18 | +Optimization.jl in the standard way: |
19 | 19 |
|
20 | 20 | ```julia
|
21 |
| -import Pkg; Pkg.add("GalacticOptim") |
| 21 | +import Pkg; Pkg.add("Optimization") |
22 | 22 | ```
|
23 |
| -The packages relevant to the core functionality of GalacticOptim.jl will be imported |
| 23 | +The packages relevant to the core functionality of Optimization.jl will be imported |
24 | 24 | accordingly and, in most cases, you do not have to worry about the manual
|
25 | 25 | installation of dependencies. Below is the list of packages that need to be
|
26 | 26 | installed explicitly if you intend to use the specific optimization algorithms
|
27 | 27 | offered by them:
|
28 | 28 |
|
29 |
| -- GalacticBBO for [BlackBoxOptim.jl](https://github.com/robertfeldt/BlackBoxOptim.jl) |
30 |
| -- GalacticEvolutionary for [Evolutionary.jl](https://github.com/wildart/Evolutionary.jl) (see also [this documentation](https://wildart.github.io/Evolutionary.jl/dev/)) |
31 |
| -- GalacticGCMAES for [GCMAES.jl](https://github.com/AStupidBear/GCMAES.jl) |
32 |
| -- GalacticMOI for [MathOptInterface.jl](https://github.com/jump-dev/MathOptInterface.jl) (usage of algorithm via MathOptInterface API; see also the API [documentation](https://jump.dev/MathOptInterface.jl/stable/)) |
33 |
| -- GalacticMetaheuristics for [Metaheuristics.jl](https://github.com/jmejia8/Metaheuristics.jl) (see also [this documentation](https://jmejia8.github.io/Metaheuristics.jl/stable/)) |
34 |
| -- GalacticMultistartOptimization for [MultistartOptimization.jl](https://github.com/tpapp/MultistartOptimization.jl) (see also [this documentation](https://juliahub.com/docs/MultistartOptimization/cVZvi/0.1.0/)) |
35 |
| -- GalacticNLopt for [NLopt.jl](https://github.com/JuliaOpt/NLopt.jl) (usage via the NLopt API; see also the available [algorithms](https://nlopt.readthedocs.io/en/latest/NLopt_Algorithms/)) |
36 |
| -- GalacticNOMAD for [NOMAD.jl](https://github.com/bbopt/NOMAD.jl) (see also [this documentation](https://bbopt.github.io/NOMAD.jl/stable/)) |
37 |
| -- GalacticNonconvex for [Nonconvex.jl](https://github.com/JuliaNonconvex/Nonconvex.jl) (see also [this documentation](https://julianonconvex.github.io/Nonconvex.jl/stable/)) |
38 |
| -- GalacticQuadDIRECT for [QuadDIRECT.jl](https://github.com/timholy/QuadDIRECT.jl) |
39 |
| -- GalacticSpeedMapping for [SpeedMapping.jl](https://github.com/NicolasL-S/SpeedMapping.jl) (see also [this documentation](https://nicolasl-s.github.io/SpeedMapping.jl/stable/)) |
| 29 | +- OptimizationBBO for [BlackBoxOptim.jl](https://github.com/robertfeldt/BlackBoxOptim.jl) |
| 30 | +- OptimizationEvolutionary for [Evolutionary.jl](https://github.com/wildart/Evolutionary.jl) (see also [this documentation](https://wildart.github.io/Evolutionary.jl/dev/)) |
| 31 | +- OptimizationGCMAES for [GCMAES.jl](https://github.com/AStupidBear/GCMAES.jl) |
| 32 | +- OptimizationMOI for [MathOptInterface.jl](https://github.com/jump-dev/MathOptInterface.jl) (usage of algorithm via MathOptInterface API; see also the API [documentation](https://jump.dev/MathOptInterface.jl/stable/)) |
| 33 | +- OptimizationMetaheuristics for [Metaheuristics.jl](https://github.com/jmejia8/Metaheuristics.jl) (see also [this documentation](https://jmejia8.github.io/Metaheuristics.jl/stable/)) |
| 34 | +- OptimizationMultistartOptimization for [MultistartOptimization.jl](https://github.com/tpapp/MultistartOptimization.jl) (see also [this documentation](https://juliahub.com/docs/MultistartOptimization/cVZvi/0.1.0/)) |
| 35 | +- OptimizationNLopt for [NLopt.jl](https://github.com/JuliaOpt/NLopt.jl) (usage via the NLopt API; see also the available [algorithms](https://nlopt.readthedocs.io/en/latest/NLopt_Algorithms/)) |
| 36 | +- OptimizationNOMAD for [NOMAD.jl](https://github.com/bbopt/NOMAD.jl) (see also [this documentation](https://bbopt.github.io/NOMAD.jl/stable/)) |
| 37 | +- OptimizationNonconvex for [Nonconvex.jl](https://github.com/JuliaNonconvex/Nonconvex.jl) (see also [this documentation](https://julianonconvex.github.io/Nonconvex.jl/stable/)) |
| 38 | +- OptimizationQuadDIRECT for [QuadDIRECT.jl](https://github.com/timholy/QuadDIRECT.jl) |
| 39 | +- OptimizationSpeedMapping for [SpeedMapping.jl](https://github.com/NicolasL-S/SpeedMapping.jl) (see also [this documentation](https://nicolasl-s.github.io/SpeedMapping.jl/stable/)) |
40 | 40 |
|
41 | 41 | ## Tutorials and Documentation
|
42 | 42 |
|
43 | 43 | For information on using the package,
|
44 |
| -[see the stable documentation](https://galacticoptim.sciml.ai/stable/). Use the |
45 |
| -[in-development documentation](https://galacticoptim.sciml.ai/dev/) for the version of |
| 44 | +[see the stable documentation](https://Optimization.sciml.ai/stable/). Use the |
| 45 | +[in-development documentation](https://Optimization.sciml.ai/dev/) for the version of |
46 | 46 | the documentation, which contains the unreleased features.
|
47 | 47 |
|
48 | 48 | ## Examples
|
49 | 49 |
|
50 | 50 | ```julia
|
51 |
| -using GalacticOptim |
| 51 | +using Optimization |
52 | 52 | rosenbrock(x,p) = (p[1] - x[1])^2 + p[2] * (x[2] - x[1]^2)^2
|
53 | 53 | x0 = zeros(2)
|
54 | 54 | p = [1.0,100.0]
|
55 | 55 |
|
56 | 56 | prob = OptimizationProblem(rosenbrock,x0,p)
|
57 | 57 |
|
58 |
| -using GalacticOptimJL |
| 58 | +using OptimizationOptimJL |
59 | 59 | sol = solve(prob,NelderMead())
|
60 | 60 |
|
61 | 61 |
|
62 |
| -using GalacticBBO |
| 62 | +using OptimizationBBO |
63 | 63 | prob = OptimizationProblem(rosenbrock, x0, p, lb = [-1.0,-1.0], ub = [1.0,1.0])
|
64 | 64 | sol = solve(prob,BBO_adaptive_de_rand_1_bin_radiuslimited())
|
65 | 65 | ```
|
@@ -99,7 +99,7 @@ We can also explore other methods in a similar way:
|
99 | 99 |
|
100 | 100 | ```julia
|
101 | 101 | using ForwardDiff
|
102 |
| -f = OptimizationFunction(rosenbrock, GalacticOptim.AutoForwardDiff()) |
| 102 | +f = OptimizationFunction(rosenbrock, Optimization.AutoForwardDiff()) |
103 | 103 | prob = OptimizationProblem(f, x0, p)
|
104 | 104 | sol = solve(prob,BFGS())
|
105 | 105 | ```
|
@@ -132,6 +132,6 @@ For instance, the above optimization task produces the following output:
|
132 | 132 | prob = OptimizationProblem(f, x0, p, lb = [-1.0,-1.0], ub = [1.0,1.0])
|
133 | 133 | sol = solve(prob, Fminbox(GradientDescent()))
|
134 | 134 | ```
|
135 |
| -The examples clearly demonstrate that GalacticOptim.jl provides an intuitive |
| 135 | +The examples clearly demonstrate that Optimization.jl provides an intuitive |
136 | 136 | way of specifying optimization tasks and offers a relatively
|
137 | 137 | easy access to a wide range of optimization algorithms.
|
0 commit comments