fastmob 0.3.2__tar.gz → 0.3.4__tar.gz

{fastmob-0.3.2 → fastmob-0.3.4}/Cargo.lock

@@ -1030,7 +1030,7 @@ dependencies = [
 
 [[package]]
 name = "fastmob-py"
-version = "0.3.2"
+version = "0.3.4"
 dependencies = [
  "ahash",
  "arrow-array",
@@ -1061,7 +1061,7 @@ dependencies = [
 
 [[package]]
 name = "fastmob-vis"
-version = "0.1.0"
+version = "0.1.1"
 dependencies = [
  "charming",
  "numpy",

fastmob-0.3.4/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: fastmob
+Version: 0.3.4
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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 :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Requires-Dist: narwhals>=1.0
+Requires-Dist: numpy
+Requires-Dist: pyarrow>=14
+Requires-Dist: geopandas ; extra == 'geo'
+Requires-Dist: shapely ; extra == 'geo'
+Requires-Dist: pyproj ; extra == 'geo'
+Requires-Dist: fastmob-vis>=0.1.1,<0.2 ; extra == 'vis'
+Provides-Extra: geo
+Provides-Extra: vis
+License-File: LICENSE
+Summary: High-performance mobility analysis with a Rust-accelerated core and backend-agnostic DataFrame API.
+Author: Gustavo Henrique Bruno dos Santos
+License-Expression: BSD-3-Clause
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Documentation, https://gefgu.github.io/fastmob/
+Project-URL: Homepage, https://github.com/gefgu/fastmob
+Project-URL: Issues, https://github.com/gefgu/fastmob/issues
+Project-URL: Repository, https://github.com/gefgu/fastmob
+
+<p align="center">
+  <img src="docs/src/assets/logo_filled.svg" alt="Fastkit-Mobility logo" width="280">
+</p>
+
+# Fastkit-Mobility
+
+[![PyPI version](https://img.shields.io/pypi/v/fastmob)](https://pypi.org/project/fastmob/)
+[![Total downloads](https://static.pepy.tech/badge/fastmob)](https://pepy.tech/projects/fastmob)
+[![Python versions](https://img.shields.io/pypi/pyversions/fastmob)](https://pypi.org/project/fastmob/)
+[![License](https://img.shields.io/pypi/l/fastmob)](LICENSE)
+
+**Fastkit-Mobility** helps researchers turn location data into insights about how
+people move. Clean GPS traces, find stops and trips, measure travel patterns,
+and simulate mobility using familiar Python dataframes. Its Rust engine handles
+compute-intensive work while you work with pandas or Polars.
+
+[Get started](https://gefgu.github.io/fastmob/learn/) · [Explore the examples](https://gefgu.github.io/fastmob/learn/) · [API reference](https://gefgu.github.io/fastmob/reference/) · [Benchmarks](https://gefgu.github.io/fastmob/features/benchmarks/)
+
+
+<p align="center">
+  <img src="docs/src/assets/images/home/home-geolife-staypoints-triplegs.png" alt="GPS fixes, detected stops and trips for one day of a GeoLife participant in Beijing" width="650">
+</p>
+
+One day of GeoLife GPS data: grey points are GPS fixes, gold circles are detected
+stops (staypoints), and coloured lines show movement between them (triplegs). Follow the [complete GeoLife example](https://gefgu.github.io/fastmob/learn/notebooks/stay-point-detection-geolife/).
+
+## Try it
+
+Install Fastkit-Mobility and pandas for this example (Python 3.9 or newer):
+
+```bash
+pip install fastmob pandas
+```
+
+Calculate each person's **radius of gyration**: a measure, in kilometres, of
+how widely their observed locations spread around their centre of movement.
+
+```python
+import pandas as pd
+from fastmob import radius_of_gyration
+
+df = pd.DataFrame({
+    "uid": ["alice"] * 3 + ["bob"] * 3,
+    "datetime": pd.to_datetime(["2020-01-01 08:00", "2020-01-01 09:00", "2020-01-01 10:00"] * 2),
+    "lat": [41.9, 42.0, 42.1, 40.7, 40.8, 41.0],
+    "lng": [12.5, 12.5, 12.6, -74.0, -74.0, -73.9],
+})
+
+print(radius_of_gyration(df))
+```
+
+```text
+     uid  radius_of_gyration
+0  alice            9.878827
+1    bob           14.423721
+```
+
+In this small example, Bob's observed locations are more spread out than
+Alice's. Explore more [individual and collective measures](https://gefgu.github.io/fastmob/learn/individual-and-collective-measures/).
+
+## What can you study?
+
+- **Clean and segment traces:** filter noisy GPS data and separate movement from stops. [Learn how](https://gefgu.github.io/fastmob/learn/clean-and-segment/).
+- **Find stops and recurring places:** identify where people spend time and group repeated visits to locations. [Learn how](https://gefgu.github.io/fastmob/learn/staypoints-and-locations/).
+- **Measure movement:** study individual ranges and travel patterns, or flows across a population. [Explore measures](https://gefgu.github.io/fastmob/learn/individual-and-collective-measures/).
+- **Work with transport networks:** route and match GPS traces to road and rail networks. [Explore network analysis](https://gefgu.github.io/fastmob/learn/network-analysis/).
+- **Model mobility:** generate synthetic trajectories or flows and compare models with observations. [Explore models](https://gefgu.github.io/fastmob/reference/models/).
+
+
+## Performance and compatibility
+
+Fastkit-Mobility uses Rust for compute-intensive operations and supports pandas,
+Polars and other eager dataframes through Narwhals. Many measure names and
+signatures follow [scikit-mobility](https://github.com/scikit-mobility/scikit-mobility).
+
+<p align="center">
+  <img src="docs/src/assets/images/home/home-benchmark-speedup.png" alt="Execution times for five mobility measures: Fastkit-Mobility with pandas compared with scikit-mobility on approximately four million Brightkite check-ins" width="800">
+</p>
+
+Average execution time for five measures on approximately 4 million time-sorted
+Brightkite check-ins. Fastkit-Mobility uses pandas; the comparison is with
+scikit-mobility. Times are averages of three runs on an Intel Core i7-10700 with
+Python 3.12, and the chart uses a logarithmic scale. The scikit-mobility input
+contained 3,999,891 rows and the Fastkit-Mobility input 4,000,000. Results depend
+on the operation, data and environment. See the [raw benchmark record](https://github.com/gefgu/fastmob_benchmarks/blob/main/benchmarks/measures/results/py312_intel_core_i7_10700_16c_brightkite4M/measures_benchmarks.json)
+and [more comparisons](https://gefgu.github.io/fastmob/features/benchmarks/).
+
+For citing a specific software release, see the [citation guide](https://gefgu.github.io/fastmob/about/#cite-fastkit-mobility).
+
+## More resources
+
+- [Guides and tutorials](https://gefgu.github.io/fastmob/learn/) · [API reference](https://gefgu.github.io/fastmob/reference/) · [Release notes](https://gefgu.github.io/fastmob/release_notes/)
+- [Contributing and development setup](docs/CONTRIBUTING.md)
+- [Report an issue](https://github.com/gefgu/fastmob/issues): include package versions, dataframe backend, a minimal example, expected behavior and the full error.
+
+For a fastmob release, set the version in `fastmob-py/Cargo.toml`, run the
+release checks, and tag the tested commit `fastmob-v<version>` (for example,
+`fastmob-v0.3.4`). Push that tag to trigger the wheel builds and PyPI release.
+Tags named only `v<version>` do not trigger the fastmob release workflow.
+
+## Status and support
+
+Fastmob is actively developed. Please include versions, dataframe backend, a
+minimal reproducible input, expected behavior, and the full error when opening
+an issue.
+
+## Citation
+
+If you use Fastkit-Mobility in research, please cite the
+[NetMob 2026 paper](https://inria.hal.science/hal-05755990):
+
+```bibtex
+@inproceedings{santos2026fastkit,
+  author    = {Santos, Gustavo H. and Viana, Aline Carneiro and
+               Pappalardo, Luca and Silva, Thiago H.},
+  title     = {Fastkit-Mobility: A High-Performance, DataFrame-Agnostic Library for Mobility Analysis},
+  booktitle = {NetMob 2026},
+  address   = {Niter{\'o}i, Brazil},
+  year      = {2026},
+  month     = oct,
+  url       = {https://inria.hal.science/hal-05755990}
+}
+```
+

fastmob-0.3.4/README.md

@@ -0,0 +1,123 @@
+<p align="center">
+  <img src="docs/src/assets/logo_filled.svg" alt="Fastkit-Mobility logo" width="280">
+</p>
+
+# Fastkit-Mobility
+
+[![PyPI version](https://img.shields.io/pypi/v/fastmob)](https://pypi.org/project/fastmob/)
+[![Total downloads](https://static.pepy.tech/badge/fastmob)](https://pepy.tech/projects/fastmob)
+[![Python versions](https://img.shields.io/pypi/pyversions/fastmob)](https://pypi.org/project/fastmob/)
+[![License](https://img.shields.io/pypi/l/fastmob)](LICENSE)
+
+**Fastkit-Mobility** helps researchers turn location data into insights about how
+people move. Clean GPS traces, find stops and trips, measure travel patterns,
+and simulate mobility using familiar Python dataframes. Its Rust engine handles
+compute-intensive work while you work with pandas or Polars.
+
+[Get started](https://gefgu.github.io/fastmob/learn/) · [Explore the examples](https://gefgu.github.io/fastmob/learn/) · [API reference](https://gefgu.github.io/fastmob/reference/) · [Benchmarks](https://gefgu.github.io/fastmob/features/benchmarks/)
+
+
+<p align="center">
+  <img src="docs/src/assets/images/home/home-geolife-staypoints-triplegs.png" alt="GPS fixes, detected stops and trips for one day of a GeoLife participant in Beijing" width="650">
+</p>
+
+One day of GeoLife GPS data: grey points are GPS fixes, gold circles are detected
+stops (staypoints), and coloured lines show movement between them (triplegs). Follow the [complete GeoLife example](https://gefgu.github.io/fastmob/learn/notebooks/stay-point-detection-geolife/).
+
+## Try it
+
+Install Fastkit-Mobility and pandas for this example (Python 3.9 or newer):
+
+```bash
+pip install fastmob pandas
+```
+
+Calculate each person's **radius of gyration**: a measure, in kilometres, of
+how widely their observed locations spread around their centre of movement.
+
+```python
+import pandas as pd
+from fastmob import radius_of_gyration
+
+df = pd.DataFrame({
+    "uid": ["alice"] * 3 + ["bob"] * 3,
+    "datetime": pd.to_datetime(["2020-01-01 08:00", "2020-01-01 09:00", "2020-01-01 10:00"] * 2),
+    "lat": [41.9, 42.0, 42.1, 40.7, 40.8, 41.0],
+    "lng": [12.5, 12.5, 12.6, -74.0, -74.0, -73.9],
+})
+
+print(radius_of_gyration(df))
+```
+
+```text
+     uid  radius_of_gyration
+0  alice            9.878827
+1    bob           14.423721
+```
+
+In this small example, Bob's observed locations are more spread out than
+Alice's. Explore more [individual and collective measures](https://gefgu.github.io/fastmob/learn/individual-and-collective-measures/).
+
+## What can you study?
+
+- **Clean and segment traces:** filter noisy GPS data and separate movement from stops. [Learn how](https://gefgu.github.io/fastmob/learn/clean-and-segment/).
+- **Find stops and recurring places:** identify where people spend time and group repeated visits to locations. [Learn how](https://gefgu.github.io/fastmob/learn/staypoints-and-locations/).
+- **Measure movement:** study individual ranges and travel patterns, or flows across a population. [Explore measures](https://gefgu.github.io/fastmob/learn/individual-and-collective-measures/).
+- **Work with transport networks:** route and match GPS traces to road and rail networks. [Explore network analysis](https://gefgu.github.io/fastmob/learn/network-analysis/).
+- **Model mobility:** generate synthetic trajectories or flows and compare models with observations. [Explore models](https://gefgu.github.io/fastmob/reference/models/).
+
+
+## Performance and compatibility
+
+Fastkit-Mobility uses Rust for compute-intensive operations and supports pandas,
+Polars and other eager dataframes through Narwhals. Many measure names and
+signatures follow [scikit-mobility](https://github.com/scikit-mobility/scikit-mobility).
+
+<p align="center">
+  <img src="docs/src/assets/images/home/home-benchmark-speedup.png" alt="Execution times for five mobility measures: Fastkit-Mobility with pandas compared with scikit-mobility on approximately four million Brightkite check-ins" width="800">
+</p>
+
+Average execution time for five measures on approximately 4 million time-sorted
+Brightkite check-ins. Fastkit-Mobility uses pandas; the comparison is with
+scikit-mobility. Times are averages of three runs on an Intel Core i7-10700 with
+Python 3.12, and the chart uses a logarithmic scale. The scikit-mobility input
+contained 3,999,891 rows and the Fastkit-Mobility input 4,000,000. Results depend
+on the operation, data and environment. See the [raw benchmark record](https://github.com/gefgu/fastmob_benchmarks/blob/main/benchmarks/measures/results/py312_intel_core_i7_10700_16c_brightkite4M/measures_benchmarks.json)
+and [more comparisons](https://gefgu.github.io/fastmob/features/benchmarks/).
+
+For citing a specific software release, see the [citation guide](https://gefgu.github.io/fastmob/about/#cite-fastkit-mobility).
+
+## More resources
+
+- [Guides and tutorials](https://gefgu.github.io/fastmob/learn/) · [API reference](https://gefgu.github.io/fastmob/reference/) · [Release notes](https://gefgu.github.io/fastmob/release_notes/)
+- [Contributing and development setup](docs/CONTRIBUTING.md)
+- [Report an issue](https://github.com/gefgu/fastmob/issues): include package versions, dataframe backend, a minimal example, expected behavior and the full error.
+
+For a fastmob release, set the version in `fastmob-py/Cargo.toml`, run the
+release checks, and tag the tested commit `fastmob-v<version>` (for example,
+`fastmob-v0.3.4`). Push that tag to trigger the wheel builds and PyPI release.
+Tags named only `v<version>` do not trigger the fastmob release workflow.
+
+## Status and support
+
+Fastmob is actively developed. Please include versions, dataframe backend, a
+minimal reproducible input, expected behavior, and the full error when opening
+an issue.
+
+## Citation
+
+If you use Fastkit-Mobility in research, please cite the
+[NetMob 2026 paper](https://inria.hal.science/hal-05755990):
+
+```bibtex
+@inproceedings{santos2026fastkit,
+  author    = {Santos, Gustavo H. and Viana, Aline Carneiro and
+               Pappalardo, Luca and Silva, Thiago H.},
+  title     = {Fastkit-Mobility: A High-Performance, DataFrame-Agnostic Library for Mobility Analysis},
+  booktitle = {NetMob 2026},
+  address   = {Niter{\'o}i, Brazil},
+  year      = {2026},
+  month     = oct,
+  url       = {https://inria.hal.science/hal-05755990}
+}
+```

{fastmob-0.3.2 → fastmob-0.3.4}/fastmob/core/base.py

@@ -47,6 +47,7 @@ class BaseDataFrame:
         return self.df.columns
 
     def to_native(self):
+        """Return the stored native dataframe (a PyArrow table for tables built by the library's own readers)."""
         return self.df
 
     def to_pandas(self):
@@ -60,7 +61,7 @@ class BaseDataFrame:
     def compare_to(self, other, value_col, *, group_col=None, metric=None):
         """Compare ``value_col`` against ``other``, optionally grouped by ``group_col``.
 
-        See :func:`fastmob.measures.evaluation.compare.compare_to`.
+        See `fastmob.measures.evaluation.compare.compare_to`.
         """
         from fastmob.measures.evaluation.compare import compare_to as _compare_to
 

{fastmob-0.3.2 → fastmob-0.3.4}/fastmob/core/flow_dataframe.py

@@ -26,7 +26,7 @@ class FlowDataFrame(BaseDataFrame):
 
     Parameters
     ----------
-    df : DataFrame-like, optional
+    df : dataframe, optional
         Source data.  Accepted types: ``pandas.DataFrame``,
         ``polars.DataFrame``, any Narwhals-compatible eager frame, ``list``,
         ``numpy.ndarray``, or ``dict``.
@@ -333,7 +333,7 @@ class FlowDataFrame(BaseDataFrame):
     ):
         """Plot origin-destination flows on an interactive Folium map.
 
-        Requires a tessellation to be attached (see :meth:`to_flowdataframe`).
+        Requires a tessellation to be attached (see `to_flowdataframe`).
 
         Parameters
         ----------

{fastmob-0.3.2 → fastmob-0.3.4}/fastmob/core/locations_dataframe.py

@@ -42,7 +42,7 @@ class Locations(BaseDataFrame):
 
     Parameters
     ----------
-    df : DataFrame-like
+    df : dataframe
         Source data; any Narwhals-compatible eager backend.
     uid_col : str, optional
         User-ID column name for user-scoped locations. Must be ``None`` for
@@ -52,7 +52,11 @@ class Locations(BaseDataFrame):
     scheme : {"cluster", "h3", "external"}, optional
         Location-ID scheme. User locations default to ``"cluster"`` and
         global locations default to ``"external"``.
-    location_id_col, center_lat_col, center_lng_col : str, optional
+    location_id_col : str, optional
+        Column name overrides.
+    center_lat_col : str, optional
+        Column name overrides.
+    center_lng_col : str, optional
         Column name overrides.
     validate : bool, optional
         When True (default), check that required columns are present.
@@ -120,9 +124,15 @@ class Locations(BaseDataFrame):
 
         Parameters
         ----------
-        tessellation : DataFrame-like
+        tessellation : dataframe
             Tile table with IDs and centres or geometries.
-        tile_id_col, lat_col, lng_col, geometry_col : str, optional
+        tile_id_col : str, optional
+            Source column names.
+        lat_col : str, optional
+            Source column names.
+        lng_col : str, optional
+            Source column names.
+        geometry_col : str, optional
             Source column names.
 
         Returns
@@ -194,11 +204,11 @@ class Locations(BaseDataFrame):
     def identify(self, staypoints: Any, method: str = "freq", **kwargs: Any) -> Locations:
         """Label each location as ``"home"``, ``"work"``, or ``"other"``.
 
-        See :func:`fastmob.preprocessing.identify_locations`.
+        See `fastmob.preprocessing.identify_locations`.
 
         Parameters
         ----------
-        staypoints : DataFrame-like or Staypoints
+        staypoints : dataframe or Staypoints
             Location-assigned visits.
         method : str, optional
             Purpose-identification method. Default is ``"freq"``.

{fastmob-0.3.2 → fastmob-0.3.4}/fastmob/core/positionfixes_dataframe.py

@@ -36,7 +36,7 @@ class Positionfixes(TrajDataFrame):
         Parameters
         ----------
         **kwargs
-            Forwarded to :func:`fastmob.preprocessing.stay_locations`
+            Forwarded to `fastmob.preprocessing.stay_locations`
             (``minutes_for_a_stop``, ``spatial_radius_km``, etc.).
 
         Returns
@@ -106,16 +106,16 @@ class Positionfixes(TrajDataFrame):
         ----------
         staypoints : Staypoints
             Staypoints previously generated from this same trajectory (ideally
-            via :meth:`generate_staypoints`, so stop-detection parameters
+            via `generate_staypoints`, so stop-detection parameters
             match).
         gap_threshold_min : float, optional
             Reserved for future gap-based tripleg splitting; unused by the
             current ``"between_staypoints"`` method. Default ``15.0``.
         **stop_kwargs
             Stop-detection parameter overrides forwarded to
-            :func:`fastmob.preprocessing.segment` (``stop_radius_km``,
+            `fastmob.preprocessing.segment` (``stop_radius_km``,
             ``minutes_for_a_stop``, ...). Defaults to the parameters recorded
-            on ``staypoints`` (from :meth:`generate_staypoints`) when not
+            on ``staypoints`` (from `generate_staypoints`) when not
             given.
 
         Returns

{fastmob-0.3.2 → fastmob-0.3.4}/fastmob/core/staypoints_dataframe.py

@@ -34,9 +34,17 @@ class Staypoints(BaseDataFrame):
 
     Parameters
     ----------
-    df : DataFrame-like
+    df : dataframe
         Source data; any Narwhals-compatible eager backend.
-    uid_col, lat_col, lng_col, started_at_col, finished_at_col : str, optional
+    uid_col : str, optional
+        Explicit column name overrides; auto-detected when None.
+    lat_col : str, optional
+        Explicit column name overrides; auto-detected when None.
+    lng_col : str, optional
+        Explicit column name overrides; auto-detected when None.
+    started_at_col : str, optional
+        Explicit column name overrides; auto-detected when None.
+    finished_at_col : str, optional
         Explicit column name overrides; auto-detected when None.
     validate : bool, optional
         When True (default), check that required columns are present and
@@ -82,12 +90,12 @@ class Staypoints(BaseDataFrame):
 
         Existing instances are returned unchanged. Raw dataframe-like inputs
         are constructed with the same column detection and validation as
-        :class:`Staypoints`, so measures can share one explicit boundary for
+        `Staypoints`, so measures can share one explicit boundary for
         accepting raw staypoint data.
 
         Parameters
         ----------
-        value : Staypoints or DataFrame-like
+        value : Staypoints or dataframe
             Existing wrapper or raw interval table.
         **column_overrides
             Explicit column names, accepted only for a raw table.
@@ -117,7 +125,7 @@ class Staypoints(BaseDataFrame):
 
         Parameters
         ----------
-        df : DataFrame-like
+        df : dataframe
             Staypoint interval table.
         started_at_col : str
             Start-time column.
@@ -193,7 +201,7 @@ class Staypoints(BaseDataFrame):
     def create_activity_flag(self, method: str = "time_threshold", time_threshold_min: float = 15.0) -> Staypoints:
         """Flag each staypoint as a genuine "activity" by dwell time.
 
-        See :func:`fastmob.preprocessing.create_activity_flag`.
+        See `fastmob.preprocessing.create_activity_flag`.
 
         Parameters
         ----------
@@ -395,14 +403,14 @@ class Staypoints(BaseDataFrame):
     def build_stvd(self, locations: Locations, **kwargs: Any) -> Any:
         """Aggregate these staypoints against a global Locations catalogue into an STVD frame.
 
-        See :func:`fastmob.measures.collective.build_stvd`.
+        See `fastmob.measures.collective.build_stvd`.
 
         Parameters
         ----------
         locations : Locations
             Global location catalogue.
         **kwargs
-            Forwarded to :func:`fastmob.measures.collective.build_stvd`.
+            Forwarded to `fastmob.measures.collective.build_stvd`.
 
         Returns
         -------
@@ -420,7 +428,7 @@ class Staypoints(BaseDataFrame):
     def interest_network(self, locations: Locations) -> Any:
         """Return the collective interest network over global ``locations``.
 
-        See :func:`fastmob.measures.collective.interest_network`.
+        See `fastmob.measures.collective.interest_network`.
 
         Returns
         -------
@@ -441,7 +449,7 @@ class Staypoints(BaseDataFrame):
     ) -> Any:
         """Compute one home-anchored mobility motif per user and day.
 
-        See :func:`fastmob.measures.individual.motifs.daily_motifs_from_staypoints`.
+        See `fastmob.measures.individual.motifs.daily_motifs_from_staypoints`.
 
         Parameters
         ----------

{fastmob-0.3.2 → fastmob-0.3.4}/fastmob/core/tours_dataframe.py

@@ -38,7 +38,7 @@ class Tours(BaseDataFrame):
 
     Parameters
     ----------
-    df : DataFrame-like
+    df : dataframe
         Source data; any Narwhals-compatible eager backend.
     uid_col : str, optional
         User-ID column name.
@@ -59,7 +59,7 @@ class Tours(BaseDataFrame):
     def from_trips(trips: Any, staypoints_with_location: Any) -> Tours:
         """Group consecutive trips into tours.
 
-        See :meth:`fastmob.core.trips_dataframe.Trips.generate_tours`.
+        See `fastmob.core.trips_dataframe.Trips.generate_tours`.
 
         Parameters
         ----------

{fastmob-0.3.2 → fastmob-0.3.4}/fastmob/core/trajectory_dataframe.py

@@ -44,7 +44,7 @@ class TrajDataFrame(BaseDataFrame):
 
     Parameters
     ----------
-    df : DataFrame-like
+    df : dataframe
         Source data.  Accepted types: ``pandas.DataFrame``, ``polars.DataFrame``,
         any Narwhals-compatible eager frame, plain ``list``, ``numpy.ndarray``, or
         ``dict``.
@@ -302,13 +302,13 @@ class TrajDataFrame(BaseDataFrame):
     def work_location(self, **kwargs):
         """Infer the most-visited weekday daytime location for each user.
 
-        Delegates to :func:`fastmob.measures.individual.work_location` using
+        Delegates to `fastmob.measures.individual.work_location` using
         this dataframe's resolved column metadata and sorted fast path.
 
         Parameters
         ----------
         **kwargs
-            Forwarded to :func:`fastmob.measures.individual.work_location`.
+            Forwarded to `fastmob.measures.individual.work_location`.
 
         Returns
         -------
@@ -343,7 +343,7 @@ class TrajDataFrame(BaseDataFrame):
             before an interpolated point is inserted. Default ``3600.0``.
         **method_kwargs
             Method-specific parameters; see
-            :func:`fastmob.trajectory.interpolate`.
+            `fastmob.trajectory.interpolate`.
 
         Returns
         -------
@@ -387,7 +387,7 @@ class TrajDataFrame(BaseDataFrame):
     def smooth(self, method: str = "kalman_cv", **method_kwargs) -> TrajDataFrame:
         """Smooth the trajectory's positions using a named algorithm.
 
-        Unlike :meth:`interpolate`, row count and row order are unchanged --
+        Unlike `interpolate`, row count and row order are unchanged --
         every point's ``(lat, lng)`` is replaced with a denoised estimate at
         its original timestamp.
 
@@ -397,7 +397,7 @@ class TrajDataFrame(BaseDataFrame):
             Only ``"kalman_cv"`` is shipped currently. Default ``"kalman_cv"``.
         **method_kwargs
             Method-specific parameters; see
-            :func:`fastmob.trajectory.smooth`.
+            `fastmob.trajectory.smooth`.
 
         Returns
         -------
@@ -491,7 +491,7 @@ class TrajDataFrame(BaseDataFrame):
             Default ``"dtw"``.
         **method_kwargs
             Method-specific parameters; see
-            :func:`fastmob.trajectory.trajectory_distance`.
+            `fastmob.trajectory.trajectory_distance`.
 
         Returns
         -------
@@ -1018,7 +1018,7 @@ class TrajDataFrame(BaseDataFrame):
         """Plot detected stop locations on an interactive Folium map.
 
         Requires a TrajDataFrame with a ``leaving_datetime`` column
-        (output of :func:`fastmob.preprocessing.stay_locations`).
+        (output of `fastmob.preprocessing.stay_locations`).
 
         Parameters
         ----------

{fastmob-0.3.2 → fastmob-0.3.4}/fastmob/core/triplegs_dataframe.py

@@ -55,7 +55,7 @@ class Triplegs(BaseDataFrame):
 
     Parameters
     ----------
-    df : DataFrame-like
+    df : dataframe
         Source data; any Narwhals-compatible eager backend.
     uid_col : str, optional
         User-ID column name.
@@ -75,7 +75,7 @@ class Triplegs(BaseDataFrame):
     def predict_transport_mode(self, method: str = "simple-coarse", categories: dict | None = None) -> Triplegs:
         """Classify each tripleg's transport mode from its average speed.
 
-        See :func:`fastmob.preprocessing.predict_transport_mode`.
+        See `fastmob.preprocessing.predict_transport_mode`.
 
         Parameters
         ----------
@@ -106,7 +106,7 @@ class Triplegs(BaseDataFrame):
     ) -> Any:
         """Aggregate this ``mode``-labeled table into a modal-split table.
 
-        See :func:`fastmob.preprocessing.calculate_modal_split`.
+        See `fastmob.preprocessing.calculate_modal_split`.
 
         Returns
         -------
@@ -124,7 +124,7 @@ class Triplegs(BaseDataFrame):
     def generate_trips(self, staypoints: Any, gap_threshold_min: float = 15.0) -> Any:
         """Group consecutive triplegs into trips.
 
-        See :meth:`fastmob.core.trips_dataframe.Trips.from_triplegs`.
+        See `fastmob.core.trips_dataframe.Trips.from_triplegs`.
 
         Examples
         --------
@@ -143,7 +143,7 @@ class Triplegs(BaseDataFrame):
     ) -> Triplegs:
         """Derive triplegs from positionfixes + already-generated staypoints.
 
-        See :meth:`fastmob.core.positionfixes_dataframe.Positionfixes.generate_triplegs`.
+        See `fastmob.core.positionfixes_dataframe.Positionfixes.generate_triplegs`.
 
         Returns
         -------