Merge branch 'v4-dev' into feature/uxarray-get-faces-containing-points

Author: fluidnumericsJoe

.gitignore

@@ -1,19 +1,13 @@
 build/*
 docs/_build/*
 docs/_downloads
-lib/
-bin/
-parcels_examples
 
-*.so
 *.log
 *.nc
 *.nc4
 !*testfields*.nc
 out-*
-*.c
 *.pyc
-*.dSYM/*
 **/*.zarr/*
 .DS_store
 

docs/index.rst

@@ -2,7 +2,7 @@ Parcels documentation
 =====================
 
 
-Welcome to the documentation of Parcels. **Parcels** (Probably A Really Computationally Efficient Lagrangian Simulator) is a set of Python classes and methods to create customisable particle tracking simulations using output from Ocean Circulation models. Parcels can be used to track passive and active particulates such as water, plankton, `plastic <http://www.topios.org/>`_ and `fish <https://github.com/Jacketless/IKAMOANA>`_.
+Welcome to the documentation of Parcels. **Parcels** provides a set of Python classes and methods to create customisable particle tracking simulations using gridded output from (ocean) circulation models. Parcels can be used to track passive and active particulates such as water, plankton, `plastic <http://www.topios.org/>`_ and `fish <https://github.com/Jacketless/IKAMOANA>`_.
 
 .. figure:: _static/homepage.gif
    :class: dark-light

tests/utils.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import struct
 from pathlib import Path
 from typing import TYPE_CHECKING
 
@@ -133,3 +134,16 @@ def assert_valid_field_data(data: xr.DataArray, grid: XGrid):
         if ax_actual is None:
             continue  # None is ok
         assert ax_actual == ax_expected, f"Expected axis {ax_expected} for dimension '{dim}', got {ax_actual}"
+
+
+def hash_float_array(arr):
+    # Adapted from https://cs.stackexchange.com/a/37965
+    h = 1
+    for f in arr:
+        # Mimic Float.floatToIntBits: converts float to 4-byte binary, then interprets as int
+        float_as_int = struct.unpack("!i", struct.pack("!f", f))[0]
+        h = 31 * h + float_as_int
+
+    # Mimic Java's HashMap hash transformation
+    h ^= (h >> 20) ^ (h >> 12)
+    return h ^ (h >> 7) ^ (h >> 4)