Merge pull request #183 from PyLops/dev

Release v0.9.0

Author: mrava87

.readthedocs.yaml

@@ -10,8 +10,6 @@ build:
   os: ubuntu-20.04
   tools:
     python: "3.9"
-  apt_packages:
-    - libopenblas-dev
 
 # Build documentation in the docs/ directory with Sphinx
 sphinx:

CHANGELOG.md

@@ -1,3 +1,16 @@
+Changelog
+=========
+
+# 0.9.0
+
+* Added :py:class:`pyproximal.optimization.palm.iPALM` solver
+* Added :py:func:`pyproximal.optimization.palm._backtracking` method to be used when `gammaf=None` and/or `gammag=None`
+* Added :py:func:`pyproximal.utils.gradtest.gradtest_proximal` and :py:func:`pyproximal.utils.gradtest.gradtest_bilinear` methods
+* Added `tol` to :py:class:`pyproximal.optimization.primal.ProximalPoint` and
+  :py:class:`pyproximal.optimization.primal.ProximalGradient` solvers
+* Modified :py:class:`pyproximal.ProxOperator.precomposition` to allow `b` being also a vector
+
+
 # 0.8.0
 
 * Added ``pyproximal.projection.L01BallProj`` and ``pyproximal.proximal.L01Ball`` operators

README.md

@@ -1,13 +1,12 @@
 ![PyProximal](https://github.com/PyLops/pyproximal/blob/dev/docs/source/_static/pyproximal_b.png)
 
 [![PyPI version](https://badge.fury.io/py/pyproximal.svg)](https://badge.fury.io/py/pyproximal)
-[![Build Status](https://travis-ci.com/PyLops/pyproximal.svg?branch=main)](https://travis-ci.com/PyLops/pyproximal)
-[![AzureDevOps Status](https://dev.azure.com/matteoravasi/PyLops/_apis/build/status%2FPyLops.pyproximal?branchName=refs%2Fpull%2F129%2Fmerge)](https://dev.azure.com/matteoravasi/PyLops/_build/latest?definitionId=10&branchName=refs%2Fpull%2F129%2Fmerge)
+[![AzureDevOps Status](https://dev.azure.com/matteoravasi/PyLops/_apis/build/status%2FPyLops.pyproximal?branchName=refs%2Fpull%2F180%2Fmerge)](https://dev.azure.com/matteoravasi/PyLops/_build/latest?definitionId=10&branchName=refs%2Fpull%2F180%2Fmerge)
 ![GithubAction Status](https://github.com/PyLops/pyproximal/workflows/PyProx/badge.svg)
 [![Documentation Status](https://readthedocs.org/projects/pyproximal/badge/?version=latest)](https://pyproximal.readthedocs.io/en/latest/?badge=latest)
 [![OS-support](https://img.shields.io/badge/OS-linux,osx-850A8B.svg)](https://github.com/PyLops/pyproximal)
 [![Slack Status](https://img.shields.io/badge/chat-slack-green.svg)](https://pylops.slack.com)
-
+[![DOI](https://joss.theoj.org/papers/10.21105/joss.06326/status.svg)](https://doi.org/10.21105/joss.06326)
 
 
 :vertical_traffic_light: :vertical_traffic_light: This library is under early development.
@@ -184,9 +183,17 @@ make docupdate
 Note that if a new example or tutorial is created (and if any change is made to a previously available example or tutorial)
 you are required to rebuild the entire documentation before your changes will be visible.
 
+## Citing
+When using PyProximal in scientific publications, please cite the following paper:
+
+- Ravasi M, Örnhag M. V., Luiken N., Leblanc O. and Uruñuela E., 2024, *<b>PyProximal - scalable convex optimization in Python</b>*,
+  Journal of Open Source Software, 9(95), 6326. doi: 10.21105/joss.06326 [(link)](https://joss.theoj.org/papers/10.21105/joss.06326)
+
+ 
 
 ## Contributors
 * Matteo Ravasi, mrava87
 * Nick Luiken, NickLuiken
 * Eneko Uruñuela, eurunuela
 * Marcus Valtonen Örnhag, marcusvaltonen
+* Olivier Leblanc, olivierleblanc

docs/source/api/index.rst

@@ -130,6 +130,18 @@ Other operators
     BilinearOperator
     LowRankFactorizedMatrix
 
+Utility functions
+-----------------
+
+.. currentmodule:: pyproximal.utils.gradtest
+
+.. autosummary::
+   :toctree: generated/
+
+    gradtest_proximal
+    gradtest_bilinear
+
+
 
 Solvers
 -------
@@ -158,6 +170,7 @@ Primal
    :toctree: generated/
 
     PALM
+    iPALM
 
 .. currentmodule:: pyproximal.optimization.pnp
 

docs/source/changelog.rst

@@ -3,6 +3,18 @@
 Changelog
 =========
 
+Version 0.9.0
+--------------
+*Released on: 16/08/2024*
+
+* Added :py:class:`pyproximal.optimization.palm.iPALM` solver
+* Added :py:func:`pyproximal.optimization.palm._backtracking` method to be used when `gammaf=None` and/or `gammag=None`
+* Added :py:func:`pyproximal.utils.gradtest.gradtest_proximal` and :py:func:`pyproximal.utils.gradtest.gradtest_bilinear` methods
+* Added `tol` to :py:class:`pyproximal.optimization.primal.ProximalPoint` and
+  :py:class:`pyproximal.optimization.primal.ProximalGradient` solvers
+* Modified :py:class:`pyproximal.ProxOperator.precomposition` to allow `b` being also a vector
+
+
 Version 0.8.0
 --------------
 *Released on: 11/03/2024*

docs/source/credits.rst

@@ -6,4 +6,5 @@ Contributors
 *  `Matteo Ravasi <https://github.com/mrava87>`_, mrava87
 *  `Nick Luiken <https://github.com/NickLuiken>`_, NickLuiken
 *  `Eneko Uruñuela <https://github.com/eurunuela>`_, eurunuela
-*  `Marcus Valtonen Örnhag <https://github.com/marcusvaltonen>`_, marcusvaltonen
+*  `Marcus Valtonen Örnhag <https://github.com/marcusvaltonen>`_, marcusvaltonen
+*  `Olivier Leblanc <https://github.com/olivierleblanc>`_, olivierleblanc

environment-dev-arm.yml

@@ -0,0 +1,27 @@
+name: pyproximal
+channels:
+  - defaults
+  - conda-forge
+  - numba
+dependencies:
+  - python>=3.8.12
+  - numpy>=1.15.0, <2.0.0
+  - scipy>=1.8.0
+  - pylops>=2.0.0
+  - scikit-image
+  - matplotlib
+  - ipython
+  - pytest
+  - Sphinx
+  - numpydoc
+  - numba
+  - icc_rt
+  - pip:
+    - bm3d
+    - pytest-runner
+    - setuptools_scm
+    - pydata-sphinx-theme
+    - sphinx-gallery
+    - nbsphinx
+    - image
+    - sphinxemoji

environment-dev.yml

@@ -5,7 +5,7 @@ channels:
   - numba
 dependencies:
   - python>=3.8.12
-  - numpy>=1.15.0
+  - numpy>=1.15.0, <2.0.0
   - scipy>=1.8.0
   - pylops>=2.0.0
   - scikit-image
@@ -17,7 +17,8 @@ dependencies:
   - numba
   - icc_rt
   - pip:
-    - bm3d
+    - bm4d<4.2.4 # temporary fix as GLIBC_2.32 not found by readthedocs
+    - bm3d<4.0.2 # temporary fix as GLIBC_2.32 not found by readthedocs
     - pytest-runner
     - setuptools_scm
     - pydata-sphinx-theme

environment.yml

@@ -3,6 +3,6 @@ channels:
   - defaults
 dependencies:
   - python>=3.8.12
-  - numpy>=1.15.0
+  - numpy>=1.15.0, <2.0.0
   - scipy>=1.8.0
   - pylops>=2.0.0

pyproject.toml

@@ -30,7 +30,7 @@ classifiers = [
     "Topic :: Scientific/Engineering :: Mathematics",
 ]
 dependencies = [
-    "numpy >= 1.15.0",
+    "numpy >= 1.15.0, <2.0.0",
     "scipy >= 1.8.0",
     "pylops >= 2.0.0",
 ]