Skip to main content

jointview

Compare two price or NAV series of a Polars DataFrame, side by side.

PyPI version

License: Apache-2.0 Python versions CI Coverage Code style: ruff uv marimo CodeFactor Rhiza Downloads

Run it

uvx jointview

That is the whole installation. uvx fetches the package and its dependencies for the length of the run and leaves nothing behind.

uvx jointview navs.parquet               # your own data
uvx jointview navs.parquet --height 900  # taller plot for a taller screen

jointview comparing two funds of the demo frame

Pick a series on each side. Both are drawn on one pair of axes, and each summary table describes exactly the rows in the plot — the common sample, where both series are present.

Why both lines share an axis

A second scale would invent a relationship that is not in the data. So both series are indexed to 100 at their first shared date, which is how a fund priced at 49 and one priced at 1,450 become comparable. The switch above the plot turns that off when the levels already share a scale.

Options

jointview the generated demo frame
jointview <file> .parquet, .csv, .tsv, .json, .ndjson, .arrow, .ipc, .feather
--height plot height in pixels (default 700)
--edit open the notebook itself, from a clone
-- … everything after a bare -- goes to marimo: -- --port 8080 --headless

The first temporal column becomes the x-axis; without one the rows are numbered. Every numeric column is offered as a series.

The pieces on their own

Neither the chart nor the statistics need marimo. uvx runs the app; to import the pieces, install the package from PyPI:

uv add jointview      # or: pip install jointview

Statistics come from jQuantStats, so the frame carries its period column into summary — the annualisation factor is read from the spacing of the observations rather than assumed.

from jointview import demo_frame, line_chart, metrics, summary

frame = demo_frame()

summary(frame, "balanced", date_col="date")                  # a formatted two-column frame
metrics(frame, "tech_fund", date_col="date")["Sharpe ratio"]  # the raw number
chart = line_chart(frame, "balanced", "tech_fund")            # a plain Altair chart

Seventeen figures per series — returns, volatility, Sharpe, Sortino, Calmar, drawdown, Ulcer index, value at risk, and the shape of the period returns. A figure that cannot be formed shows as rather than blanking the table.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jointview-0.3.0.tar.gz (20.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

jointview-0.3.0-py3-none-any.whl (24.0 kB view details)

Uploaded Python 3

File details

Details for the file jointview-0.3.0.tar.gz.

File metadata

  • Download URL: jointview-0.3.0.tar.gz
  • Upload date:
  • Size: 20.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for jointview-0.3.0.tar.gz
Algorithm Hash digest
SHA256 4248f9e9427306835f6bee2a33a61ad366eb388c44e5c2074e2a9622606f6f0f
MD5 75ec54c9a33d66688d9f19961b6fb4d2
BLAKE2b-256 c7813f3d71a832da36997aedd225f7f894b77ec4e0a667dbb1d0f02ba6de98b2

See more details on using hashes here.

Provenance

The following attestation bundles were made for jointview-0.3.0.tar.gz:

Publisher: rhiza_release.yml on Jebel-Quant/jointview

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file jointview-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: jointview-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 24.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for jointview-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4d2bc1304de0f0472b572383db12dea0554a404377ac327564ad035c2bd1a0bb
MD5 8b75856605a8cf31f63c3f5ceda5abd2
BLAKE2b-256 7e2beffb43e4ff8552b42e0720f7ae4d8ca8e37477d634af43249344c9f8fc3b

See more details on using hashes here.

Provenance

The following attestation bundles were made for jointview-0.3.0-py3-none-any.whl:

Publisher: rhiza_release.yml on Jebel-Quant/jointview

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page