Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

More documentation and visualisation fixes #214

Merged
merged 12 commits into from
Sep 24, 2024
Merged

More documentation and visualisation fixes #214

merged 12 commits into from
Sep 24, 2024

Conversation

adigitoleo
Copy link
Member

Adds a <200LOC cornerflow example to the docs website, with output (hopefully).

Fixes voigt averaging and tweaks the main 2D flow visualisation function so that colorbars work as in the paper.

Adds buttons to get to PyPI and GitHub to the docs landing page.

Migrates build tasks runner from make to just, which is just better, especially in our use case (spiel in the commit message of f17c6c2).

The [just](https://github.com/casey/just) build command runner is "just"
a better `make`, for our purposes. In particular, it properly terminates
the documentation build if `setuptools-scm` is not installed. I'm sure
there is a way to cast spells at `make` to make it do that, but why?
Whenever there's a big .PHONY line in a Makefile, it means that `make`
is probably the wrong tool. Also, the old Makefile I provided was only
valid for GNU make (make portability is a bit gross).

Also, `just` has binaries built for every major platform so installing
is not a hassle.
@adigitoleo

This comment was marked as resolved.

Copy link
Member

@Patol75 Patol75 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Another great set of improvements! Some very minor comments from my side.

README.md Outdated Show resolved Hide resolved
src/pydrex/__init__.py Outdated Show resolved Hide resolved
examples/standalone/cornerflow_simple.py Show resolved Hide resolved
@adigitoleo adigitoleo merged commit fb44b02 into main Sep 24, 2024
10 checks passed
@adigitoleo adigitoleo deleted the docs-touchup branch September 25, 2024 04:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants