Skip to content

Home

Jump to bottom
Jason Frazier edited this page Jun 9, 2025 · 2 revisions

Welcome to the Puddy Wiki

Puddy is a modern Python toolkit for analyzing, visualizing, and detecting anomalies in spatial trajectory data.

Whether you work with GPS tracks, flight paths, vessel movements, or any set of coordinates over time, Puddy helps you:

  • Read data from almost any common format (CSV, JSON, JSONL, Parquet, DataFrame)
  • Normalize and group trajectories for consistent analysis
  • Extract rich features about movement and shape
  • Detect anomalous behaviors with powerful machine learning
  • Visualize results in 3D with a single line of code

🚀 Getting Started

  • Installation:

    pip install puddy

  • Quick start example:

    from puddy import TrajectoryCollection, ColumnConfig

config = ColumnConfig.create_geo(lon_col="lon", lat_col="lat", alt_col="alt", identifier_col="id")
collection = TrajectoryCollection()
collection.load_from_file("mydata.csv", config=config)
collection.visualize_sample(n=5)

📖 What Can I Do With Puddy?

  • Import trajectory data from multiple sources with a single API
  • Control how data is grouped and normalized by specifying your own columns
  • Extract and inspect trajectory features for machine learning or reporting
  • Detect outliers using unsupervised models with one command
  • Plot trajectories and anomaly scores for presentation or exploration

📚 Where Next?

  • API Reference
    In-depth details for every function and class

  • How-To Guides
    Common tasks: loading tricky data, using in Jupyter, advanced anomaly detection, and more

  • Troubleshooting
    Fix common errors and data quirks

🙋 Need Help?

  • Open an issue or discussion on GitHub
  • Pull requests and suggestions are welcome!

Happy analyzing!

Clone this wiki locally