|
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