Wrap gradient_free_optimizers (local)

docs/source/algorithms.md

@@ -4652,6 +4652,227 @@ Optimizers from the
 package are available in optimagic. To use it, you need to have
 [gradient_free_optimizers](https://pypi.org/project/gradient_free_optimizers) installed.
 
+```{eval-rst}
+.. dropdown:: gfo_hillclimbing
+
+  **How to use this algorithm.**
+
+  .. code-block:: python
+
+    import optimagic as om
+    import numpy as np
+    om.minimize(
+      fun=lambda x: x @ x,
+      params=[1.0, 2.0, 3.0],
+      algorithm=om.algos.gfo_hillclimbing(stopping_maxiter=1_000, ...),
+      bounds = om.Bounds(lower = np.array([1,1,1]), upper=np.array([5,5,5]))
+    )
+
+  or using the string interface:
+
+  .. code-block:: python
+
+    om.minimize(
+      fun=lambda x: x @ x,
+      params=[1.0, 2.0, 3.0],
+      algorithm="gfo_hillclimbing",
+      algo_options={"stopping_maxiter": 1_000, ...},
+      bounds = om.Bounds(lower = np.array([1,1,1]), upper=np.array([5,5,5]))
+    )
+
+  **Description and available options:**
+
+  .. autoclass:: optimagic.optimizers.gfo_optimizers.GFOHillClimbing
+    :members:
+    :inherited-members: Algorithm, object
+
+```
+
+```{eval-rst}
+.. dropdown:: gfo_stochastichillclimbing
+
+  **How to use this algorithm.**
+
+  .. code-block:: python
+
+    import optimagic as om
+    import numpy as np
+    om.minimize(
+      fun=lambda x: x @ x,
+      params=[1.0, 2.0, 3.0],
+      algorithm=om.algos.gfo_stochastichillclimbing(stopping_maxiter=1_000, ...),
+      bounds = om.Bounds(lower = np.array([1,1,1]), upper=np.array([5,5,5]))
+    )
+
+  or using the string interface:
+
+  .. code-block:: python
+
+    om.minimize(
+      fun=lambda x: x @ x,
+      params=[1.0, 2.0, 3.0],
+      algorithm="gfo_stochastichillclimbing",
+      algo_options={"stopping_maxiter": 1_000, ...},
+      bounds = om.Bounds(lower = np.array([1,1,1]), upper=np.array([5,5,5]))
+    )
+
+  **Description and available options:**
+
+  .. autoclass:: optimagic.optimizers.gfo_optimizers.GFOStochasticHillClimbing
+    :members:
+    :inherited-members: Algorithm, object  
+    :member-order: bysource
+
+```
+
+```{eval-rst}
+.. dropdown:: gfo_repulsinghillclimbing
+
+  **How to use this algorithm.**
+
+  .. code-block:: python
+
+    import optimagic as om
+    import numpy as np
+    om.minimize(
+      fun=lambda x: x @ x,
+      params=[1.0, 2.0, 3.0],
+      algorithm=om.algos.gfo_repulsinghillclimbing(stopping_maxiter=1_000, ...),
+      bounds = om.Bounds(lower = np.array([1,1,1]), upper=np.array([5,5,5]))
+    )
+
+  or using the string interface:
+
+  .. code-block:: python
+
+    om.minimize(
+      fun=lambda x: x @ x,
+      params=[1.0, 2.0, 3.0],
+      algorithm="gfo_repulsinghillclimbing",
+      algo_options={"stopping_maxiter": 1_000, ...},
+      bounds = om.Bounds(lower = np.array([1,1,1]), upper=np.array([5,5,5]))
+    )
+
+  **Description and available options:**
+
+  .. autoclass:: optimagic.optimizers.gfo_optimizers.GFORepulsingHillClimbing
+    :members:
+    :inherited-members: Algorithm, object  
+    :member-order: bysource
+
+```
+
+```{eval-rst}
+.. dropdown:: gfo_simulatedannealing
+
+  **How to use this algorithm.**
+
+  .. code-block:: python
+
+    import optimagic as om
+    import numpy as np
+    om.minimize(
+      fun=lambda x: x @ x,
+      params=[1.0, 2.0, 3.0],
+      algorithm=om.algos.gfo_simulatedannealing(stopping_maxiter=1_000, ...),
+      bounds = om.Bounds(lower = np.array([1,1,1]), upper=np.array([5,5,5]))
+    )
+
+  or using the string interface:
+
+  .. code-block:: python
+
+    om.minimize(
+      fun=lambda x: x @ x,
+      params=[1.0, 2.0, 3.0],
+      algorithm="gfo_simulatedannealing",
+      algo_options={"stopping_maxiter": 1_000, ...},
+      bounds = om.Bounds(lower = np.array([1,1,1]), upper=np.array([5,5,5]))
+    )
+
+  **Description and available options:**
+
+  .. autoclass:: optimagic.optimizers.gfo_optimizers.GFOSimulatedAnnealing
+    :members:
+    :inherited-members: Algorithm, object  
+    :member-order: bysource
+
+```
+
+```{eval-rst}
+.. dropdown:: gfo_downhillsimplex
+
+  **How to use this algorithm.**
+
+  .. code-block:: python
+
+    import optimagic as om
+    import numpy as np
+    om.minimize(
+      fun=lambda x: x @ x,
+      params=[1.0, 2.0, 3.0],
+      algorithm=om.algos.gfo_downhillsimplex(stopping_maxiter=1_000, ...),
+      bounds = om.Bounds(lower = np.array([1,1,1]), upper=np.array([5,5,5]))
+    )
+
+  or using the string interface:
+
+  .. code-block:: python
+
+    om.minimize(
+      fun=lambda x: x @ x,
+      params=[1.0, 2.0, 3.0],
+      algorithm="gfo_downhillsimplex",
+      algo_options={"stopping_maxiter": 1_000, ...},
+      bounds = om.Bounds(lower = np.array([1,1,1]), upper=np.array([5,5,5]))
+    )
+
+  **Description and available options:**
+
+  .. autoclass:: optimagic.optimizers.gfo_optimizers.GFODownhillSimplex
+    :members:
+    :inherited-members: Algorithm, object  
+    :member-order: bysource
+
+```
+
+```{eval-rst}
+.. dropdown:: gfo_powells_method
+
+  **How to use this algorithm.**
+
+  .. code-block:: python
+
+    import optimagic as om
+    import numpy as np
+    om.minimize(
+      fun=lambda x: x @ x,
+      params=[1.0, 2.0, 3.0],
+      algorithm=om.algos.gfo_powells_method(stopping_maxiter=1_000, ...),
+      bounds = om.Bounds(lower = np.array([1,1,1]), upper=np.array([5,5,5]))
+    )
+
+  or using the string interface:
+
+  .. code-block:: python
+
+    om.minimize(
+      fun=lambda x: x @ x,
+      params=[1.0, 2.0, 3.0],
+      algorithm="gfo_powells_method",
+      algo_options={"stopping_maxiter": 1_000, ...},
+      bounds = om.Bounds(lower = np.array([1,1,1]), upper=np.array([5,5,5]))
+    )
+
+  **Description and available options:**
+
+  .. autoclass:: optimagic.optimizers.gfo_optimizers.GFOPowellsMethod
+    :members:
+    :inherited-members: Algorithm, object  
+    :member-order: bysource
+
+```
+
 ```{eval-rst}
 .. dropdown:: gfo_pso
 
@@ -4660,6 +4881,7 @@ package are available in optimagic. To use it, you need to have
   .. code-block:: python
 
     import optimagic as om
+    import numpy as np
     om.minimize(
       fun=lambda x: x @ x,
       params=[1.0, 2.0, 3.0],
@@ -4682,6 +4904,9 @@ package are available in optimagic. To use it, you need to have
   **Description and available options:**
 
   .. autoclass:: optimagic.optimizers.gfo_optimizers.GFOParticleSwarmOptimization
+    :members:
+    :inherited-members: Algorithm, object  
+    :member-order: bysource
 
 ```
 
@@ -4717,6 +4942,9 @@ package are available in optimagic. To use it, you need to have
   **Description and available options:**
 
   .. autoclass:: optimagic.optimizers.gfo_optimizers.GFOParallelTempering
+    :members:
+    :inherited-members: Algorithm, object  
+    :member-order: bysource
 ```
 
 ```{eval-rst}
@@ -4750,6 +4978,9 @@ package are available in optimagic. To use it, you need to have
   **Description and available options:**
 
   .. autoclass:: optimagic.optimizers.gfo_optimizers.GFOSpiralOptimization
+    :members:
+    :inherited-members: Algorithm, object  
+    :member-order: bysource
 ```
 
 ```{eval-rst}
@@ -4783,6 +5014,9 @@ package are available in optimagic. To use it, you need to have
   **Description and available options:**
 
   .. autoclass:: optimagic.optimizers.gfo_optimizers.GFOGeneticAlgorithm
+    :members:
+    :inherited-members: Algorithm, object  
+    :member-order: bysource
 ```
 
 ```{eval-rst}
@@ -4816,6 +5050,9 @@ package are available in optimagic. To use it, you need to have
   **Description and available options:**
 
   .. autoclass:: optimagic.optimizers.gfo_optimizers.GFOEvolutionStrategy
+    :members:
+    :inherited-members: Algorithm, object  
+    :member-order: bysource
 ```
 
 ```{eval-rst}
@@ -4849,6 +5086,9 @@ package are available in optimagic. To use it, you need to have
   **Description and available options:**
 
   .. autoclass:: optimagic.optimizers.gfo_optimizers.GFODifferentialEvolution
+    :members:
+    :inherited-members: Algorithm, object  
+    :member-order: bysource
 
 ```
 

docs/source/how_to/how_to_bounds.ipynb

@@ -319,7 +319,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.10.16"
+   "version": "3.12.11"
   }
  },
  "nbformat": 4,