[pre-commit.ci] auto fixes from pre-commit.com hooks

pre-commit-ci[bot] · pre-commit-ci[bot] · commit 1787edb0334f · 2025-09-28T12:26:26.000Z
for more information, see https://pre-commit.ci
diff --git a/parcels/__init__.py b/parcels/__init__.py
@@ -4,13 +4,13 @@
 
 import warnings as _stdlib_warnings
 
-from parcels._logger import logger
-from parcels._tutorial import download_example_dataset, list_example_datasets
-from parcels._core.warnings import (
-    FieldSetWarning,
-    FileWarning,
-    KernelWarning,
-    ParticleSetWarning,
+from parcels._core.basegrid import BaseGrid
+from parcels._core.converters import (
+    Geographic,
+    GeographicPolar,
+    GeographicPolarSquare,
+    GeographicSquare,
+    UnitConverter,
 )
 from parcels._core.field import Field, VectorField
 from parcels._core.fieldset import FieldSet
@@ -25,25 +25,24 @@
 from parcels._core.particleset import ParticleSet
 from parcels._core.statuscodes import (
     AllParcelsErrorCodes,
+    FieldInterpolationError,
     FieldOutOfBoundError,
     FieldSamplingError,
     KernelError,
     StatusCode,
-    FieldInterpolationError,
     TimeExtrapolationError,
 )
-from parcels.utils import *
-
-from parcels._core.converters import (
-    Geographic,
-    GeographicPolar,
-    GeographicPolarSquare,
-    GeographicSquare,
-    UnitConverter,
+from parcels._core.uxgrid import UxGrid
+from parcels._core.warnings import (
+    FieldSetWarning,
+    FileWarning,
+    KernelWarning,
+    ParticleSetWarning,
 )
 from parcels._core.xgrid import XGrid
-from parcels._core.uxgrid import UxGrid
-from parcels._core.basegrid import BaseGrid
+from parcels._logger import logger
+from parcels._tutorial import download_example_dataset, list_example_datasets
+from parcels.utils import *
 
 _stdlib_warnings.warn(
     "This is an alpha version of Parcels v4. The API is not stable and may change without deprecation warnings.",
diff --git a/parcels/_core/basegrid.py b/parcels/_core/basegrid.py
@@ -1,4 +1,3 @@
-
 from __future__ import annotations
 
 from abc import ABC, abstractmethod
diff --git a/parcels/_core/field.py b/parcels/_core/field.py
@@ -8,7 +8,19 @@
 import uxarray as ux
 import xarray as xr
 
+from parcels._core.constants import LEFT_OUT_OF_BOUNDS, RIGHT_OUT_OF_BOUNDS
+from parcels._core.converters import (
+    UnitConverter,
+    _unitconverters_map,
+)
+from parcels._core.particle import KernelParticle
+from parcels._core.statuscodes import (
+    AllParcelsErrorCodes,
+    StatusCode,
+)
 from parcels._core.utils.time import TimeInterval
+from parcels._core.uxgrid import UxGrid
+from parcels._core.xgrid import XGrid, _transpose_xfield_data_to_tzyx
 from parcels._reprs import default_repr
 from parcels._typing import VectorType
 from parcels.interpolators import (
@@ -17,19 +29,7 @@
     ZeroInterpolator,
     ZeroInterpolator_Vector,
 )
-from parcels._core.particle import KernelParticle
-from parcels._core.statuscodes import (
-    AllParcelsErrorCodes,
-    StatusCode,
-)
 from parcels.utils._helpers import _assert_same_function_signature
-from parcels._core.converters import (
-    UnitConverter,
-    _unitconverters_map,
-)
-from parcels._core.uxgrid import UxGrid
-from parcels._core.xgrid import XGrid, _transpose_xfield_data_to_tzyx
-from parcels._core.constants import RIGHT_OUT_OF_BOUNDS, LEFT_OUT_OF_BOUNDS
 
 from .._index_search import GRID_SEARCH_ERROR, _search_time_index
 
diff --git a/parcels/_core/fieldset.py b/parcels/_core/fieldset.py
@@ -9,17 +9,17 @@
 import xarray as xr
 import xgcm
 
+from parcels._core.converters import Geographic, GeographicPolar
+from parcels._core.field import Field, VectorField
 from parcels._core.utils.time import get_datetime_type_calendar
 from parcels._core.utils.time import is_compatible as datetime_is_compatible
+from parcels._core.xgrid import _DEFAULT_XGCM_KWARGS, XGrid
 from parcels._logger import logger
 from parcels._typing import Mesh
-from parcels._core.field import Field, VectorField
-from parcels._core.converters import Geographic, GeographicPolar
-from parcels._core.xgrid import _DEFAULT_XGCM_KWARGS, XGrid
 
 if TYPE_CHECKING:
-    from parcels._typing import TimeLike
     from parcels._core.basegrid import BaseGrid
+    from parcels._typing import TimeLike
 __all__ = ["FieldSet"]
 
 
diff --git a/parcels/_core/kernel.py b/parcels/_core/kernel.py
@@ -8,13 +8,7 @@
 
 import numpy as np
 
-from parcels._core.warnings import KernelWarning
 from parcels._core.basegrid import GridType
-from parcels.kernels import (
-    AdvectionAnalytical,
-    AdvectionRK4,
-    AdvectionRK45,
-)
 from parcels._core.statuscodes import (
     StatusCode,
     _raise_field_interpolation_error,
@@ -24,6 +18,12 @@
     _raise_grid_searching_error,
     _raise_time_extrapolation_error,
 )
+from parcels._core.warnings import KernelWarning
+from parcels.kernels import (
+    AdvectionAnalytical,
+    AdvectionRK4,
+    AdvectionRK45,
+)
 from parcels.utils._helpers import _assert_same_function_signature
 
 if TYPE_CHECKING:
diff --git a/parcels/_core/particle.py b/parcels/_core/particle.py
@@ -8,9 +8,9 @@
 import numpy as np
 
 from parcels._compat import _attrgetter_helper
+from parcels._core.statuscodes import StatusCode
 from parcels._core.utils.time import TimeInterval
 from parcels._reprs import _format_list_items_multiline
-from parcels._core.statuscodes import StatusCode
 
 __all__ = ["KernelParticle", "Particle", "ParticleClass", "Variable"]
 _TO_WRITE_OPTIONS = [True, False, "once"]
diff --git a/parcels/_core/particlefile.py b/parcels/_core/particlefile.py
@@ -18,9 +18,9 @@
 from parcels.utils._helpers import timedelta_to_float
 
 if TYPE_CHECKING:
-    from parcels._core.utils.time import TimeInterval
     from parcels._core.particle import Variable
     from parcels._core.particleset import ParticleSet
+    from parcels._core.utils.time import TimeInterval
 
 __all__ = ["ParticleFile"]
 
diff --git a/parcels/_core/particleset.py b/parcels/_core/particleset.py
@@ -9,15 +9,15 @@
 from tqdm import tqdm
 from zarr.storage import DirectoryStore
 
+from parcels._core.converters import _convert_to_flat_array
+from parcels._core.kernel import Kernel
+from parcels._core.particle import KernelParticle, Particle, create_particle_data
+from parcels._core.statuscodes import StatusCode
 from parcels._core.utils.time import TimeInterval, maybe_convert_python_timedelta_to_numpy
+from parcels._core.warnings import ParticleSetWarning
 from parcels._logger import logger
 from parcels._reprs import particleset_repr
-from parcels._core.warnings import ParticleSetWarning
-from parcels._core.kernel import Kernel
 from parcels.kernels import AdvectionRK4
-from parcels._core.particle import KernelParticle, Particle, create_particle_data
-from parcels._core.statuscodes import StatusCode
-from parcels._core.converters import _convert_to_flat_array
 
 __all__ = ["ParticleSet"]
 
diff --git a/parcels/_core/spatialhash.py b/parcels/_core/spatialhash.py
@@ -1,6 +1,5 @@
 import numpy as np
 
-import parcels
 from parcels._index_search import GRID_SEARCH_ERROR, _latlon_rad_to_xyz, curvilinear_point_in_cell, uxgrid_point_in_cell
 from parcels._python import isinstance_noimport
 
diff --git a/parcels/_core/utils/array.py b/parcels/_core/utils/array.py
@@ -1,4 +1,5 @@
 import numpy as np
+
 from parcels._core.constants import LEFT_OUT_OF_BOUNDS, RIGHT_OUT_OF_BOUNDS
 
 
diff --git a/parcels/_core/uxgrid.py b/parcels/_core/uxgrid.py
@@ -5,11 +5,10 @@
 import numpy as np
 import uxarray as ux
 
+from parcels._core.basegrid import BaseGrid
+from parcels._core.utils.array import _search_1d_array
 from parcels._index_search import GRID_SEARCH_ERROR, uxgrid_point_in_cell
 from parcels._typing import assert_valid_mesh
-from parcels._core.utils.array import _search_1d_array
-
-from parcels._core.basegrid import BaseGrid
 
 _UXGRID_AXES = Literal["Z", "FACE"]
 
diff --git a/parcels/_core/xgrid.py b/parcels/_core/xgrid.py
@@ -7,10 +7,10 @@
 import xarray as xr
 import xgcm
 
-from parcels._index_search import _search_indices_curvilinear_2d
-from parcels._typing import assert_valid_mesh
 from parcels._core.basegrid import BaseGrid
 from parcels._core.utils.array import _search_1d_array
+from parcels._index_search import _search_indices_curvilinear_2d
+from parcels._typing import assert_valid_mesh
 
 _XGRID_AXES = Literal["X", "Y", "Z"]
 _XGRID_AXES_ORDERING: Sequence[_XGRID_AXES] = "ZYX"
diff --git a/parcels/_index_search.py b/parcels/_index_search.py
@@ -8,9 +8,8 @@
 from parcels._core.statuscodes import _raise_time_extrapolation_error
 
 if TYPE_CHECKING:
-    from parcels.xgrid import XGrid
-
     from parcels._core.field import Field
+    from parcels.xgrid import XGrid
 
 
 GRID_SEARCH_ERROR = -3
diff --git a/parcels/interaction/interactionkernel.py b/parcels/interaction/interactionkernel.py
@@ -6,8 +6,8 @@
 
 from parcels._compat import MPI
 from parcels._core.field import VectorField
-from parcels.kernel import BaseKernel
 from parcels._core.statuscodes import StatusCode
+from parcels.kernel import BaseKernel
 
 __all__ = ["InteractionKernel"]
 
diff --git a/tests-v3/test_interaction.py b/tests-v3/test_interaction.py
@@ -2,6 +2,7 @@
 import pytest
 
 from parcels import Field, FieldSet, ParticleSet
+from parcels._core.particle import InteractionParticle, Variable
 from parcels.interaction.neighborsearch import (
     BruteFlatNeighborSearch,
     BruteSphericalNeighborSearch,
@@ -16,7 +17,6 @@
     MergeWithNearestNeighbor,
     NearestNeighborWithinRange,
 )
-from parcels._core.particle import InteractionParticle, Variable
 from tests.common_kernels import DoNothing
 from tests.utils import create_fieldset_unit_mesh, create_flat_positions, create_spherical_positions
 
diff --git a/tests-v3/tools/test_warnings.py b/tests-v3/tools/test_warnings.py
@@ -8,10 +8,10 @@
     FieldSetWarning,
     KernelWarning,
     Particle,
+    ParticleFile,
     ParticleSet,
     ParticleSetWarning,
 )
-from parcels import ParticleFile
 from tests.utils import TEST_DATA
 
 
diff --git a/tests/test_advection.py b/tests/test_advection.py
@@ -4,6 +4,7 @@
 import xgcm
 
 import parcels
+from parcels import Field, FieldSet, Particle, ParticleFile, ParticleSet, StatusCode, Variable, VectorField, XGrid
 from parcels._datasets.structured.generated import (
     decaying_moving_eddy_dataset,
     moving_eddy_dataset,
@@ -12,8 +13,6 @@
     simple_UV_dataset,
     stommel_gyre_dataset,
 )
-from parcels import Field, VectorField
-from parcels import FieldSet
 from parcels.interpolators import CGrid_Velocity, XLinear
 from parcels.kernels import (
     AdvectionDiffusionEM,
@@ -23,11 +22,6 @@
     AdvectionRK4_3D,
     AdvectionRK45,
 )
-from parcels import Particle, Variable
-from parcels import ParticleFile
-from parcels import ParticleSet
-from parcels import StatusCode
-from parcels import XGrid
 from tests.utils import round_and_hash_float_array
 
 kernel = {
diff --git a/tests/test_datasets.py b/tests/test_datasets.py
@@ -1,7 +1,7 @@
 import xgcm
 
-from parcels._datasets.structured.generic import datasets
 from parcels._core.xgrid import _DEFAULT_XGCM_KWARGS
+from parcels._datasets.structured.generic import datasets
 
 
 def test_left_indexed_dataset():
diff --git a/tests/test_diffusion.py b/tests/test_diffusion.py
@@ -4,14 +4,10 @@
 import pytest
 from scipy import stats
 
+from parcels import Field, FieldSet, Particle, ParticleSet, Variable, VectorField, XGrid
 from parcels._datasets.structured.generated import simple_UV_dataset
-from parcels import Field, VectorField
-from parcels import FieldSet
 from parcels.interpolators import XLinear
 from parcels.kernels import AdvectionDiffusionEM, AdvectionDiffusionM1, DiffusionUniformKh
-from parcels import Particle, Variable
-from parcels import ParticleSet
-from parcels import XGrid
 from tests.utils import create_fieldset_zeros_conversion
 
 
diff --git a/tests/test_field.py b/tests/test_field.py
@@ -5,13 +5,11 @@
 import uxarray as ux
 import xarray as xr
 
-from parcels import Field, VectorField
+from parcels import Field, UxGrid, VectorField, XGrid
 from parcels._datasets.structured.generic import T as T_structured
 from parcels._datasets.structured.generic import datasets as datasets_structured
 from parcels._datasets.unstructured.generic import datasets as datasets_unstructured
 from parcels.interpolators import UXPiecewiseConstantFace, UXPiecewiseLinearNode
-from parcels import UxGrid
-from parcels import XGrid
 
 
 def test_field_init_param_types():
diff --git a/tests/test_fieldset.py b/tests/test_fieldset.py
@@ -6,12 +6,11 @@
 import pytest
 import xarray as xr
 
+from parcels import Field, VectorField, XGrid
+from parcels._core.fieldset import CalendarError, FieldSet, _datetime_to_msg
 from parcels._datasets.structured.circulation_models import datasets as datasets_circulation_models
 from parcels._datasets.structured.generic import T as T_structured
 from parcels._datasets.structured.generic import datasets as datasets_structured
-from parcels import Field, VectorField
-from parcels._core.fieldset import CalendarError, FieldSet, _datetime_to_msg
-from parcels import XGrid
 from tests import utils
 
 ds = datasets_structured["ds_2d_left"]
diff --git a/tests/test_index_search.py b/tests/test_index_search.py
@@ -3,11 +3,10 @@
 import xarray as xr
 import xgcm
 
+from parcels import Field, XGrid
 from parcels._datasets.structured.generic import datasets
 from parcels._index_search import _search_indices_curvilinear_2d
 from parcels._tutorial import download_example_dataset
-from parcels import Field
-from parcels import XGrid
 
 
 @pytest.fixture
diff --git a/tests/test_interpolation.py b/tests/test_interpolation.py
diff --git a/tests/test_kernel.py b/tests/test_kernel.py
diff --git a/tests/test_particle.py b/tests/test_particle.py
diff --git a/tests/test_particlefile.py b/tests/test_particlefile.py
diff --git a/tests/test_particleset.py b/tests/test_particleset.py
diff --git a/tests/test_particleset_execute.py b/tests/test_particleset_execute.py
diff --git a/tests/test_spatialhash.py b/tests/test_spatialhash.py
diff --git a/tests/test_uxarray_fieldset.py b/tests/test_uxarray_fieldset.py
diff --git a/tests/test_uxgrid.py b/tests/test_uxgrid.py
diff --git a/tests/test_xgrid.py b/tests/test_xgrid.py
diff --git a/tests/utils.py b/tests/utils.py

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,3 @@`
`1`		`-`
`2`	`1`	`from __future__ import annotations`
`3`	`2`
`4`	`3`	`from abc import ABC, abstractmethod`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,5 @@`
`1`	`1`	`import numpy as np`
	`2`	`+`
`2`	`3`	`from parcels._core.constants import LEFT_OUT_OF_BOUNDS, RIGHT_OUT_OF_BOUNDS`
`3`	`4`
`4`	`5`