OpenPIV 0.25.2__tar.gz → 0.25.4__tar.gz

{openpiv-0.25.2 → openpiv-0.25.4}/PKG-INFO

@@ -1,10 +1,11 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: OpenPIV
-Version: 0.25.2
+Version: 0.25.4
 Summary: OpenPIV consists in a Python and Cython modules for scripting and executing the analysis of a set of PIV image pairs. In addition, a Qt and Tk graphical user interfaces are in development, to ease the use for those users who don't have python skills.
 License: GPLv3
+License-File: LICENSE.txt
 Author: Alex Liberzon
-Requires-Python: >=3.7,<3.11
+Requires-Python: >=3.10
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
@@ -15,32 +16,27 @@ Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: OS Independent
 Classifier: Operating System :: POSIX
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Scientific/Engineering
-Requires-Dist: imageio (>=2.22.4,<3.0.0)
-Requires-Dist: importlib_resources (==5.12.0)
-Requires-Dist: matplotlib (>=3,<4)
-Requires-Dist: natsort (>=8.4.0,<9.0.0)
-Requires-Dist: numpy (>=1.21.6,<2.0.0)
-Requires-Dist: scikit-image (>=0.19.3,<0.20.0)
-Requires-Dist: scipy (>=1.7.3,<2.0.0)
-Requires-Dist: tqdm (>=4.66.1,<5.0.0)
+Requires-Dist: imageio (>=2.35.0)
+Requires-Dist: matplotlib (>=3.8.0)
+Requires-Dist: natsort (>=8.4.0)
+Requires-Dist: numpy (>=2.0.0)
+Requires-Dist: scikit-image (>=0.23.0)
+Requires-Dist: scipy (>=1.11.0)
+Requires-Dist: tqdm (>=4.66.0)
 Project-URL: Documentation, http://openpiv.readthedocs.org
 Project-URL: Repository, https://pypi.python.org/pypi/OpenPIV
 Description-Content-Type: text/markdown
 
 # OpenPIV
-[![Build Status](https://travis-ci.org/OpenPIV/openpiv-python.svg?branch=master)](https://travis-ci.org/OpenPIV/openpiv-python)
-![Build and upload to PyPI](https://github.com/OpenPIV/openpiv-python/workflows/Build%20and%20upload%20to%20PyPI/badge.svg)
-[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.4409178.svg)](https://doi.org/10.5281/zenodo.4409178)
-
-
-
+[![Python package](https://github.com/OpenPIV/openpiv-python/actions/workflows/testing.yml/badge.svg)](https://github.com/OpenPIV/openpiv-python/actions/workflows/testing.yml)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18304582.svg)](https://doi.org/10.5281/zenodo.18304582)
 ![PyPI](https://img.shields.io/pypi/v/openpiv)
-[![Anaconda-Server Badge](https://anaconda.org/alexlib/openpiv/badges/version.svg)](https://anaconda.org/alexlib/openpiv)
 
 
 OpenPIV consists in a Python and Cython modules for scripting and executing the analysis of 
@@ -63,18 +59,36 @@ Click the link - thanks to BinderHub, Jupyter and Conda you can now get it in yo
 
 ## Installing
 
+### Recommended: Using uv (fastest)
+
+[uv](https://github.com/astral-sh/uv) is a fast Python package installer and resolver written in Rust:
+
+    pip install uv
+    uv pip install openpiv
+
+### Using pip (standard)
+
 Use PyPI: <https://pypi.python.org/pypi/OpenPIV>:
 
     pip install openpiv
 
+### Or [Poetry](https://python-poetry.org/)
 
-## Or `conda` 
+    poetry add openpiv
 
-    conda install -c alexlib openpiv
+### Note on Conda/Anaconda
 
-## Or [Poetry](https://python-poetry.org/)
+⚠️ **Conda packages are no longer actively maintained.** The conda-forge package may be outdated.
 
-    poetry add openpiv
+If you previously installed OpenPIV via conda, you can migrate to pip or uv:
+
+    # Remove the conda package
+    conda remove openpiv
+    
+    # Install with pip or uv
+    pip install openpiv
+    # or
+    uv pip install openpiv
     
     
 ### To build from source

{openpiv-0.25.2 → openpiv-0.25.4}/README.md

@@ -1,12 +1,7 @@
 # OpenPIV
-[![Build Status](https://travis-ci.org/OpenPIV/openpiv-python.svg?branch=master)](https://travis-ci.org/OpenPIV/openpiv-python)
-![Build and upload to PyPI](https://github.com/OpenPIV/openpiv-python/workflows/Build%20and%20upload%20to%20PyPI/badge.svg)
-[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.4409178.svg)](https://doi.org/10.5281/zenodo.4409178)
-
-
-
+[![Python package](https://github.com/OpenPIV/openpiv-python/actions/workflows/testing.yml/badge.svg)](https://github.com/OpenPIV/openpiv-python/actions/workflows/testing.yml)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18304582.svg)](https://doi.org/10.5281/zenodo.18304582)
 ![PyPI](https://img.shields.io/pypi/v/openpiv)
-[![Anaconda-Server Badge](https://anaconda.org/alexlib/openpiv/badges/version.svg)](https://anaconda.org/alexlib/openpiv)
 
 
 OpenPIV consists in a Python and Cython modules for scripting and executing the analysis of 
@@ -29,18 +24,36 @@ Click the link - thanks to BinderHub, Jupyter and Conda you can now get it in yo
 
 ## Installing
 
+### Recommended: Using uv (fastest)
+
+[uv](https://github.com/astral-sh/uv) is a fast Python package installer and resolver written in Rust:
+
+    pip install uv
+    uv pip install openpiv
+
+### Using pip (standard)
+
 Use PyPI: <https://pypi.python.org/pypi/OpenPIV>:
 
     pip install openpiv
 
+### Or [Poetry](https://python-poetry.org/)
 
-## Or `conda` 
+    poetry add openpiv
 
-    conda install -c alexlib openpiv
+### Note on Conda/Anaconda
 
-## Or [Poetry](https://python-poetry.org/)
+⚠️ **Conda packages are no longer actively maintained.** The conda-forge package may be outdated.
 
-    poetry add openpiv
+If you previously installed OpenPIV via conda, you can migrate to pip or uv:
+
+    # Remove the conda package
+    conda remove openpiv
+    
+    # Install with pip or uv
+    pip install openpiv
+    # or
+    uv pip install openpiv
     
     
 ### To build from source

{openpiv-0.25.2 → openpiv-0.25.4}/openpiv/PIV_3D_plotting.py

@@ -71,7 +71,7 @@ def scatter_3D(a, cmap="jet", sca_args=None, control="color", size=60):
         sm = matplotlib.cm.ScalarMappable(cmap=cmap, norm=norm)
         sm.set_array([])
         # different option
-        cm = matplotlib.cm.get_cmap(cmap)
+        cm = matplotlib.colormaps.get_cmap(cmap)
         colors = cm(norm(a)).reshape(a.shape[0] * a.shape[1] * a.shape[2], 4)  #
         # plotting
         nan_filter = ~np.isnan(a.flatten())
@@ -83,7 +83,7 @@ def scatter_3D(a, cmap="jet", sca_args=None, control="color", size=60):
             s=size,
             **scatter_args
         )
-        plt.colorbar(sm)
+        fig.colorbar(sm, ax=ax)
 
     if control == "alpha":
         # untested #
@@ -92,8 +92,12 @@ def scatter_3D(a, cmap="jet", sca_args=None, control="color", size=60):
         plt.show()
 
     if control == "size":
-        sizes = (a - a.min()) * size / a.ptp()
-        ax.scatter(x, y, z, a, s=sizes, **scatter_args)
+        value_range = np.ptp(a)
+        if value_range == 0:
+            sizes = np.full(a.shape, size, dtype=float)
+        else:
+            sizes = (a - a.min()) * size / value_range
+        ax.scatter(x, y, z, c=a.flatten(), s=sizes.flatten(), **scatter_args)
         ax_scale = plt.axes([0.88, 0.1, 0.05, 0.7])
         # ax_scale.set_ylim((0.1,1.2))
         nm = 5
@@ -172,12 +176,13 @@ def plot_3D_alpha(data):
     z[:, :, 1::2] += 0.95
 
     fig = plt.figure()
-    ax = fig.gca(projection="3d")
+    ax = fig.add_subplot(projection="3d")
     ax.voxels(x, y, z, fill, facecolors=col_exp, edgecolors=col_exp)
     ax.set_xlabel("x")
     ax.set_ylabel("y")
     ax.set_zlabel("z")
     plt.show()
+    return fig
 
 
 def quiver_3D(
@@ -332,11 +337,11 @@ def quiver_3D(
 
     # plotting
     fig = plt.figure()
-    ax = fig.gca(projection="3d", rasterized=True)
+    ax = fig.add_subplot(projection="3d", rasterized=True)
     ax.quiver(
         xf, yf, zf, vf * scale, uf * scale, wf * scale, colors=colors, **quiver_args
     )
-    plt.colorbar(sm)
+    fig.colorbar(sm, ax=ax)
 
     ax.set_xlim(ax_dims[0])
     ax.set_ylim(ax_dims[1])
@@ -348,8 +353,9 @@ def quiver_3D(
     ax.set_xlabel("x")
     ax.set_ylabel("y")
     ax.set_zlabel("z")
-    ax.w_xaxis.set_pane_color((0.2, 0.2, 0.2, 1.0))
-    ax.w_yaxis.set_pane_color((0.2, 0.2, 0.2, 1.0))
-    ax.w_zaxis.set_pane_color((0.2, 0.2, 0.2, 1.0))
+    for axis in (ax.xaxis, ax.yaxis, ax.zaxis):
+        pane = getattr(axis, "pane", None)
+        if pane is not None:
+            pane.set_facecolor((0.2, 0.2, 0.2, 1.0))
 
     return fig

openpiv-0.25.4/openpiv/__init__.py

@@ -0,0 +1,10 @@
+from importlib.metadata import version
+
+
+__version__ = version("OpenPIV")
+
+
+def test():
+    import pytest
+
+    pytest.main()

openpiv-0.25.4/openpiv/data/test1/test_data.vec

@@ -0,0 +1,71 @@
+# x	y	u	v	flags	mask
+4.0406e-01	3.3983e+00	-5.2592e-03	-5.9910e-02	0.0000e+00	0.0000e+00
+9.0137e-01	3.3983e+00	-9.6075e-04	-6.4036e-02	0.0000e+00	0.0000e+00
+1.3987e+00	3.3983e+00	-3.4784e-06	-5.9356e-02	1.0000e+00	0.0000e+00
+1.8960e+00	3.3983e+00	4.9192e-03	-6.1691e-02	0.0000e+00	0.0000e+00
+2.3933e+00	3.3983e+00	-9.2873e-04	-5.6505e-02	1.0000e+00	0.0000e+00
+2.8906e+00	3.3983e+00	-5.9565e-03	-5.0575e-02	0.0000e+00	0.0000e+00
+3.3879e+00	3.3983e+00	2.1094e-04	-5.7925e-02	0.0000e+00	0.0000e+00
+3.8852e+00	3.3983e+00	-2.7240e-03	-6.0472e-02	0.0000e+00	0.0000e+00
+4.3825e+00	3.3983e+00	-3.7283e-03	-5.8267e-02	1.0000e+00	0.0000e+00
+4.8798e+00	3.3983e+00	2.4173e-03	-6.4150e-02	0.0000e+00	0.0000e+00
+4.0406e-01	2.9010e+00	-1.8216e-03	-5.4789e-02	0.0000e+00	0.0000e+00
+9.0137e-01	2.9010e+00	-1.8865e-04	-5.9088e-02	1.0000e+00	0.0000e+00
+1.3987e+00	2.9010e+00	5.2738e-03	-5.5928e-02	0.0000e+00	0.0000e+00
+1.8960e+00	2.9010e+00	8.0944e-03	-5.4726e-02	0.0000e+00	0.0000e+00
+2.3933e+00	2.9010e+00	-2.6124e-03	-5.5983e-02	0.0000e+00	0.0000e+00
+2.8906e+00	2.9010e+00	-4.3661e-03	-5.1347e-02	0.0000e+00	0.0000e+00
+3.3879e+00	2.9010e+00	-3.3565e-03	-5.6682e-02	0.0000e+00	0.0000e+00
+3.8852e+00	2.9010e+00	-3.5475e-03	-6.1713e-02	0.0000e+00	0.0000e+00
+4.3825e+00	2.9010e+00	-3.8556e-03	-5.6242e-02	1.0000e+00	0.0000e+00
+4.8798e+00	2.9010e+00	-6.4612e-03	-6.4347e-02	0.0000e+00	0.0000e+00
+4.0406e-01	2.4036e+00	8.3705e-04	-5.9559e-02	0.0000e+00	0.0000e+00
+9.0137e-01	2.4036e+00	1.4459e-03	-6.0987e-02	0.0000e+00	0.0000e+00
+1.3987e+00	2.4036e+00	-3.0819e-04	-5.8402e-02	1.0000e+00	0.0000e+00
+1.8960e+00	2.4036e+00	-7.8548e-03	-6.5643e-02	0.0000e+00	0.0000e+00
+2.3933e+00	2.4036e+00	-6.7928e-04	-6.3742e-02	0.0000e+00	0.0000e+00
+2.8906e+00	2.4036e+00	1.2726e-04	-4.9550e-02	0.0000e+00	0.0000e+00
+3.3879e+00	2.4036e+00	-6.4997e-03	-4.9535e-02	0.0000e+00	0.0000e+00
+3.8852e+00	2.4036e+00	-5.7793e-03	-5.4359e-02	0.0000e+00	0.0000e+00
+4.3825e+00	2.4036e+00	-7.7358e-03	-5.8984e-02	0.0000e+00	0.0000e+00
+4.8798e+00	2.4036e+00	-3.6829e-03	-5.6436e-02	1.0000e+00	0.0000e+00
+4.0406e-01	1.9063e+00	-8.4074e-03	-5.9327e-02	0.0000e+00	0.0000e+00
+9.0137e-01	1.9063e+00	2.5401e-03	-5.4095e-02	0.0000e+00	0.0000e+00
+1.3987e+00	1.9063e+00	-3.3883e-03	-5.7585e-02	0.0000e+00	0.0000e+00
+1.8960e+00	1.9063e+00	1.9393e-03	-5.9907e-02	0.0000e+00	0.0000e+00
+2.3933e+00	1.9063e+00	1.4774e-03	-6.0280e-02	0.0000e+00	0.0000e+00
+2.8906e+00	1.9063e+00	-1.7161e-03	-5.2136e-02	0.0000e+00	0.0000e+00
+3.3879e+00	1.9063e+00	-9.2400e-03	-4.8946e-02	0.0000e+00	0.0000e+00
+3.8852e+00	1.9063e+00	-7.1067e-03	-4.8031e-02	0.0000e+00	0.0000e+00
+4.3825e+00	1.9063e+00	-1.2505e-03	-5.2882e-02	0.0000e+00	0.0000e+00
+4.8798e+00	1.9063e+00	6.4614e-04	-5.0812e-02	0.0000e+00	0.0000e+00
+4.0406e-01	1.4090e+00	2.2486e-03	-5.0550e-02	0.0000e+00	0.0000e+00
+9.0137e-01	1.4090e+00	-6.7877e-03	-5.4202e-02	0.0000e+00	0.0000e+00
+1.3987e+00	1.4090e+00	-2.5288e-03	-6.3126e-02	0.0000e+00	0.0000e+00
+1.8960e+00	1.4090e+00	-5.9178e-04	-5.8457e-02	0.0000e+00	0.0000e+00
+2.3933e+00	1.4090e+00	5.8459e-03	-5.2184e-02	0.0000e+00	0.0000e+00
+2.8906e+00	1.4090e+00	5.4790e-03	-4.3826e-02	0.0000e+00	0.0000e+00
+3.3879e+00	1.4090e+00	-7.8645e-04	-5.1268e-02	0.0000e+00	0.0000e+00
+3.8852e+00	1.4090e+00	-5.9201e-03	-5.2166e-02	0.0000e+00	0.0000e+00
+4.3825e+00	1.4090e+00	-4.3095e-03	-5.2602e-02	0.0000e+00	0.0000e+00
+4.8798e+00	1.4090e+00	-2.2094e-03	-5.4975e-02	0.0000e+00	0.0000e+00
+4.0406e-01	9.1173e-01	9.7924e-03	-5.5734e-02	0.0000e+00	0.0000e+00
+9.0137e-01	9.1173e-01	7.5636e-03	-5.2847e-02	0.0000e+00	0.0000e+00
+1.3987e+00	9.1173e-01	9.0445e-03	-4.9824e-02	0.0000e+00	0.0000e+00
+1.8960e+00	9.1173e-01	1.4482e-03	-5.3496e-02	0.0000e+00	0.0000e+00
+2.3933e+00	9.1173e-01	-3.3418e-03	-5.3215e-02	0.0000e+00	0.0000e+00
+2.8906e+00	9.1173e-01	-5.2835e-03	-4.9696e-02	0.0000e+00	0.0000e+00
+3.3879e+00	9.1173e-01	-5.0878e-03	-5.0559e-02	0.0000e+00	0.0000e+00
+3.8852e+00	9.1173e-01	-5.8373e-03	-5.1331e-02	0.0000e+00	0.0000e+00
+4.3825e+00	9.1173e-01	-9.5435e-04	-5.1071e-02	0.0000e+00	0.0000e+00
+4.8798e+00	9.1173e-01	-1.7836e-03	-5.0735e-02	0.0000e+00	0.0000e+00
+4.0406e-01	4.1442e-01	7.7151e-03	-5.9321e-02	0.0000e+00	0.0000e+00
+9.0137e-01	4.1442e-01	1.0424e-02	-5.2889e-02	0.0000e+00	0.0000e+00
+1.3987e+00	4.1442e-01	-1.2132e-03	-5.1367e-02	0.0000e+00	0.0000e+00
+1.8960e+00	4.1442e-01	1.8418e-03	-5.2428e-02	1.0000e+00	0.0000e+00
+2.3933e+00	4.1442e-01	3.0095e-03	-4.7837e-02	0.0000e+00	0.0000e+00
+2.8906e+00	4.1442e-01	2.7171e-03	-5.1027e-02	0.0000e+00	0.0000e+00
+3.3879e+00	4.1442e-01	-5.2003e-03	-5.0522e-02	0.0000e+00	0.0000e+00
+3.8852e+00	4.1442e-01	-4.6899e-03	-5.3185e-02	0.0000e+00	0.0000e+00
+4.3825e+00	4.1442e-01	-2.9401e-03	-5.4006e-02	0.0000e+00	0.0000e+00
+4.8798e+00	4.1442e-01	2.9101e-03	-5.1380e-02	0.0000e+00	0.0000e+00

{openpiv-0.25.2 → openpiv-0.25.4}/openpiv/docs/conf.py

@@ -64,7 +64,7 @@ copyright = '2014, OpenPIV team'
 # built documents.
 #
 # The short X.Y version.
-version = '0.24.4a'
+version = '0.25.4'
 # The full version, including alpha/beta/rc tags.
 # release = '0.0.1a'
 

{openpiv-0.25.2 → openpiv-0.25.4}/openpiv/docs/requirements.txt

@@ -1,4 +1,3 @@
-numpy>=1.9
 openpiv
 sphinx
 recommonmark

{openpiv-0.25.2 → openpiv-0.25.4}/openpiv/docs/src/installation_instruction.rst

@@ -19,23 +19,42 @@ The dependencies are:
 * `Python <http://python.org/>`_
 * `Scipy <http://numpy.scipy.org/>`_
 * `Numpy <http://www.scipy.org/>`_
-* `scikit-image <http://scikit-image.org/>`_
-
-On all platforms, the following Python distribution is recommended:
-
-* Anaconda <https://store.continuum.io/cshop/anaconda/>   
+* `scikit-image <http://scikit-image.org/>`_   
 
 
 Installation
 ============
 
-Use `conda` :: 
+Recommended: Use `uv` (fastest)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+`uv <https://github.com/astral-sh/uv>`_ is a fast Python package installer and resolver written in Rust.
+It provides faster and more reliable package installation compared to traditional tools.
+
+To install OpenPIV with uv::
 
-    conda install -c alexlib openpiv
+    pip install uv
+    uv pip install openpiv
 
-Or use `pip` :: 
+Or use `pip` (standard)
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+::
 
     pip install openpiv
+
+.. warning::
+    **Conda packages are no longer actively maintained.** The conda-forge package may be outdated.
+    
+    If you previously installed OpenPIV via conda, you can migrate to pip or uv::
+    
+        # Remove the conda package
+        conda remove openpiv
+        
+        # Install with pip or uv
+        pip install openpiv
+        # or
+        uv pip install openpiv
     
 Get OpenPIV source code!
 ========================

{openpiv-0.25.2 → openpiv-0.25.4}/openpiv/filters.py

@@ -44,8 +44,13 @@ def _gaussian_kernel(half_width: int=1)-> np.ndarray:
 
     """
     # size = int(half_width)
-    x, y = np.mgrid[-half_width:half_width + 1, -half_width:half_width + 1]
-    g = np.exp(-(x ** 2 / float(half_width) + y ** 2 / float(half_width)))
+
+    if half_width == 0:
+        return 1
+    else: 
+        x, y = np.mgrid[-half_width:half_width + 1, -half_width:half_width + 1]
+        g = np.exp(-(x ** 2 / float(half_width) + y ** 2 / float(half_width)))
+    
     return g / g.sum()
 
 
@@ -169,21 +174,21 @@ def replace_outliers(
     # regardless the grid_mask (which is a user-provided masked region)
 
     
-    if not isinstance(u, np.ma.MaskedArray):
-        u = np.ma.masked_array(u, mask=np.ma.nomask)
-        
-    # store grid_mask for reinforcement
-    grid_mask = u.mask.copy()
-
-    u[flags] = np.nan
-    v[flags] = np.nan
+    has_mask = isinstance(u, np.ma.MaskedArray)
+    grid_mask = np.ma.getmaskarray(u).copy() if has_mask else np.ma.nomask
+
+    u_data = np.array(np.ma.getdata(u), copy=True)
+    v_data = np.array(np.ma.getdata(v), copy=True)
+
+    u_data[flags] = np.nan
+    v_data[flags] = np.nan
     
     uf = replace_nans(
-        u, method=method, max_iter=max_iter, tol=tol,
+        u_data, method=method, max_iter=max_iter, tol=tol,
         kernel_size=kernel_size
     )
     vf = replace_nans(
-        v, method=method, max_iter=max_iter, tol=tol,
+        v_data, method=method, max_iter=max_iter, tol=tol,
         kernel_size=kernel_size
     )
 
@@ -192,9 +197,10 @@ def replace_outliers(
     vf = np.ma.masked_array(vf, mask=grid_mask)
 
     if isinstance(w, np.ndarray):
-        w[flags] = np.nan
+        w_data = np.array(np.ma.getdata(w), copy=True)
+        w_data[flags] = np.nan
         wf = replace_nans(
-            w, method=method, max_iter=max_iter, tol=tol,
+            w_data, method=method, max_iter=max_iter, tol=tol,
             kernel_size=kernel_size
         )
         wf = np.ma.masked_array(wf, mask=grid_mask)

{openpiv-0.25.2 → openpiv-0.25.4}/openpiv/lib.py

@@ -2,7 +2,6 @@ import numpy as np
 
 
 def replace_nans(array, max_iter, tol, kernel_size=2, method="disk"):
-
     """Replace NaN elements in an array using an iterative image inpainting
         algorithm.
 
@@ -18,26 +17,15 @@ def replace_nans(array, max_iter, tol, kernel_size=2, method="disk"):
          threshold.
 
       Methods:
-
-      localmean - A square kernel where all elements have the same value,
-                  weights are equal to n/( (2*kernel_size+1)**2 -1 ),
-                  where n is the number of non-NaN elements.
-      disk - A circular kernel where all elements have the same value,
-             kernel is calculated by::
-                 if ((S-i)**2 + (S-j)**2)**0.5 <= S:
-                     kernel[i,j] = 1.0
-                 else:
-                     kernel[i,j] = 0.0
-             where S is the kernel radius.
-      distance - A circular inverse distance kernel where elements are
-                 weighted proportional to their distance away from the
-                 center of the kernel, elements farther away have less
-                 weight. Elements outside the specified radius are set
-                 to 0.0 as in 'disk', the remaining of the weights are
-                 calculated as::
-                     maxDist = ((S)**2 + (S)**2)**0.5
-                     kernel[i,j] = -1*(((S-i)**2 + (S-j)**2)**0.5 - maxDist)
-                 where S is the kernel radius.
+        localmean - A square kernel where all elements have the same weight.
+        disk - A circular kernel where all elements have the same weight.
+        distance - A circular kernel where the weight of each element depends
+                 on its distance from the center of the kernel. The weights
+                 are given by a function of the form:
+                   w_i = 1 - (d_i / d_max)^2
+                 where d_i is the distance from the center, and d_max is the
+                 distance of the element farthest from the center.
+                 This method requires SciPy.
 
       Parameters
       ----------
@@ -68,6 +56,9 @@ def replace_nans(array, max_iter, tol, kernel_size=2, method="disk"):
           a copy of the input array, where NaN elements have been replaced.
 
       """
+    # Check if there are any NaNs to replace
+    if not np.any(np.isnan(array)):
+        return array.copy()
 
     kernel_size = int(kernel_size)
     filled = array.copy()