Update the documentation to use parquet output

[erikvansebille]

Description

This PR updates all the documentation and tutorial notebooks to parse the parquet output introduced in #2600, as tracked in #2582. It also updated the parcels.read_particlefile() to use polars, which scales better for large output files

Checklist

• Contributes to Migrate particlefile output to tabular (via Parquet) #2582
• Tests added
• This PR targets the correct branch (main for normal development, v3-support for v3 support)

AI Disclosure

• This PR contains AI-generated content.
  • I have tested any AI-generated content in my PR.
  • I take responsibility for any AI-generated content in my PR.
  • Describe how you used it (e.g., by pasting your prompt): Help with how to use polars

[VeckoTheGecko]

As part of review I've looked both at the code, as well as visually compared plots before and after.

I've gone through and pushed some edits which were quite straight-forward:

• 1b35bf9 Fixing a notebook
• d977c88e7

Now the docs builds are passing

Other than that, I have some small comments - nothing major.

---

Given we're now using Polars in the docs, the tests, and in the read_particlefile function - I think its easiest just for us to add it as a core dependency to Parcels. We could make it an optional dependency, but we don't really have the tooling for that in Parcels (and I don't think its worth adding the tooling in this case).

If we add as a core dependency:

• Update pyproject.toml and pixi.toml (run-dependencies to = ">=1.31.0" and feature.minimum.dependencies to = "1.31.*")
• Update recipe.yaml

I'm happy to make those updates.

[VeckoTheGecko]

This assert should be updated pending the discussion from the other comment on the read_particlefile function.

[erikvansebille]

Added a TODO in 0241c28 .

[VeckoTheGecko]

I've gone through this - really nice update! I think its quite clear

[VeckoTheGecko]

Given we're now using Polars in the docs, the tests, and in the read_particlefile function - I think its easiest just for us to add it as a core dependency to Parcels. We could make it an optional dependency, but we don't really have the tooling for that in Parcels (and I don't think its worth adding the tooling in this case).

If we add as a core dependency:

• Update pyproject.toml and pixi.toml (run-dependencies to = ">=1.31.0" and feature.minimum.dependencies to = "1.31.*")
• Update recipe.yaml

I'm happy to make those updates.

Do you agree with this @erikvansebille ?

[erikvansebille]

Yes sorry, missed that comment about the polars dependency, and merged too fast. Can you make these updates in a new PR?

[VeckoTheGecko]

All good, can do :)