CLImax (a Command Line IMAge eXplorer)
Installing CLImax
We recommend that you install CLImax as a tool using uv:
$ uv tool install climax-rfglab
or
$ uvx --from climax-rfglab climax
A CLImax executable will be created, which allows the tool to be run without uv. If the directory that contains the CLImax executable is not in the PATH, a warning will be displayed and the following command can be issued to add it to the PATH:
$ uv tool update-shell
CLImax can also be installed as a regular Python package using uv:
$ uv pip install climax-rfglab
or pip:
$ python3 -m pip install climax-rfglab
A note on the Python interpreter
CLImax requires that you have Python 3.10 or above installed.
A note for developers
If you want to download the code and run from source, you will first need to compile the part of CLImax that uses Rust. The simplest way to do that is to install maturin and run the following command within the CLImax folder:
$ maturin develop --release
After that, you can run CLImax with:
$ python -m climax.climax
Using CLImax
After installing CLImax with one of the methods above, You can invoke it with:
$ climax <filename>
You can also run CLImax without installing it, taking advantage of uvx:
$ uvx --from climax-rfglab climax <filename>
There are a few ways to open an image with CLImax:
-
You can specifiy the path to the image that you want to open (e.g. tests/fixtures/gray_stack.tif) ... :
$ climax tests/fixtures/gray_stack.tif -
... including zarr images (e.g. tests/fixtures/4D_stack.zarr):
$ climax tests/fixtures/4D_stack.zarr -
Or you can indicate a folder (slices in this example) that contains an image sequence:
$ climax ./slices -
If there are image channels split into different files, you can specify a group of substrings to distinguish which files in the folder belong to which channel. For example, to open the files in the slices folder containing the substrings '488' and '561' as two different channels:
$ climax ./slices -s 488 561 -
You can use a list of paths to concatenate sideways (i.e. display side-by-side, but all the images must have the same dimensions!!):
$ climax cells_movie_1.tif cells_movie_2.tif -
You can specify the color map used to display the image. The color map defaults to 'gray'. Check here for a list of color maps.
$ climax cells_movie.tif -c viridis -
Notice that if you try to open a color image, the channels will be displayed as different dimensions. Thus, for instance, if you open the CLImax logo:
-
You can indicate the zoom factor initially used to display the image. Keep in mind that larger zoom values will take longer to render. The default value is 1.0, but you can select any of the values in climax.zoom_factors (currently 0.03125, 0.0625, 0.125, 0.25, 0.5, 1., 2., 4., 8., 16., and 32.):
$ climax cells_movie.tif -z 2.0
The CLImax dashboard provides tools to display and manipulate images:
| name | function |
|---|---|
| rotate | rotate 90° clockwise |
| flip h. | flip horizontally |
| flip v. | flip vertically |
| invert | invert color map |
| update | continuous/discrete update |
| x-y, z-y, z-x | slicing plane |
| auto | automated contrast adjustment (min-mode, max-99th percentile) |
The dashboard also shows the histogram of the image currently on display. The histogram is updated in real time as the user explores the image.
A command bar provides additional functionality that can be invoked with the mouse or with several quick-keys:
| key | function |
|---|---|
| . | next slice |
| , | previous slice |
| + | zoom in, uses nearest-neighbour or bilinear interpolation |
| - | zoom out, uses nearest-neighbour or bilinear interpolation |
| k | toggle dark mode on/off, initially off |
| o | open a new image |
| t | open an image sequence (select a folder) |
| i | toggle bilinear interpolation on/off, initially off (i.e. nearest neighbour interpolation) |
CLImax today
As we develop and improve CLImax, there may be changes to the user interface. This is how CLImax looks as of today:
Citing CLImax
If you use CLImax, please cite this repository. We are working on the paper!
Sponsors
We are grateful for the generous support from the following agencies and institutions, which contribute to the development and maintenance of CLImax:
1 maintainer
Release files for climax-rfglab 2025.10.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| climax_rfglab-2025.10.6.tar.gz | 34.4 MB | Details |
Built distributions (wheels)
Total release size: 37.0 MB
Release files / climax_rfglab-2025.10.6.tar.gz
| Download URL | climax_rfglab-2025.10.6.tar.gz |
|---|---|
| Size | 34.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
38ccbe9c5deaea128efbcdd81d5ed323cedf1c46978258dff6dcc69046bfdd8d
|
|
BLAKE2b-256 checksum How to use checksums |
08ca5b747531b085b7ad65941779d96d84d4922dbe702525e1df8445941d8538
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 27, 2025.
Transparency logRelease files / climax_rfglab-2025.10.6-cp314-cp314t-win_amd64.whl
| Download URL | climax_rfglab-2025.10.6-cp314-cp314t-win_amd64.whl |
|---|---|
| Size | 192.0 kB |
| Tags | CPython 3.14 CPython 3.14 free-threading Windows x86-64 |
|
SHA-256 checksum How to use checksums |
7e1c6e518e451658c71336be9aca71ef41677889689ee86576ddd401d10f1308
|
|
BLAKE2b-256 checksum How to use checksums |
ac69b29fef17508fb26a38253c25b0574d489f90ec88a5c332695fda5fc8353f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 27, 2025.
Transparency logRelease files / climax_rfglab-2025.10.6-cp314-cp314t-win32.whl
| Download URL | climax_rfglab-2025.10.6-cp314-cp314t-win32.whl |
|---|---|
| Size | 184.4 kB |
| Tags | CPython 3.14 CPython 3.14 free-threading Windows x86-32 |
|
SHA-256 checksum How to use checksums |
9ac916b919ca062a6195e427bc25bb745b3f5ae6765019004b2c21f078eae22f
|
|
BLAKE2b-256 checksum How to use checksums |
973a93f7f2afdbb4df334b8c2c9d66a3c1cf0549f50bc1a8629fb4f27c8c762e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 27, 2025.
Transparency logRelease files / climax_rfglab-2025.10.6-cp314-cp314t-manylinux_2_28_x86_64.whl
| Download URL | climax_rfglab-2025.10.6-cp314-cp314t-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 317.3 kB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
cb9e12f7afcecf7373687c70a6cc66187a802e07b2d6f407ff0f4bda12a7f217
|
|
BLAKE2b-256 checksum How to use checksums |
016192afe35abf5c11247a3f34572b470faf10b4e5b6219245037ad8d2c97adf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 27, 2025.
Transparency logRelease files / climax_rfglab-2025.10.6-cp314-cp314t-macosx_11_0_arm64.whl
| Download URL | climax_rfglab-2025.10.6-cp314-cp314t-macosx_11_0_arm64.whl |
|---|---|
| Size | 281.3 kB |
| Tags | CPython 3.14 CPython 3.14 free-threading macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
04c6afcb48794ed453b119e1b80bc532e001592ba62202624a114698d948edd1
|
|
BLAKE2b-256 checksum How to use checksums |
b6c54fcb1b9ad5d2f45d8a30ae34312ab1ee549681977e76fe57c578294eda91
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 27, 2025.
Transparency logRelease files / climax_rfglab-2025.10.6-cp314-cp314t-macosx_10_13_x86_64.whl
| Download URL | climax_rfglab-2025.10.6-cp314-cp314t-macosx_10_13_x86_64.whl |
|---|---|
| Size | 294.3 kB |
| Tags | CPython 3.14 CPython 3.14 free-threading macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
4088647002b7889d945e561de2091d7e7668a57141871836dc99dc7764364f64
|
|
BLAKE2b-256 checksum How to use checksums |
c46edbc9fbc7889317d64a21b5e99ffe42deea5dc0f6bf666ec8ca02ba27dc5c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 27, 2025.
Transparency logRelease files / climax_rfglab-2025.10.6-cp310-abi3-win_amd64.whl
| Download URL | climax_rfglab-2025.10.6-cp310-abi3-win_amd64.whl |
|---|---|
| Size | 192.6 kB |
| Tags | CPython 3.10 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
4fbb6785388b80a8cb4d395f16ea219f46a53f13f1c3124a74a46e55dbeb7b73
|
|
BLAKE2b-256 checksum How to use checksums |
58b641cb70dff7b22a452eb114ad54855ccc7d29dd9fa9d930baf93e17dca802
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 27, 2025.
Transparency logRelease files / climax_rfglab-2025.10.6-cp310-abi3-win32.whl
| Download URL | climax_rfglab-2025.10.6-cp310-abi3-win32.whl |
|---|---|
| Size | 185.2 kB |
| Tags | CPython 3.10 Windows x86-32 abi3 |
|
SHA-256 checksum How to use checksums |
132b6422ecb9949c926df5d533da681c9611cd6d583c9e3ba445c05a1afa342a
|
|
BLAKE2b-256 checksum How to use checksums |
e17832db87c128bd4b714042045025335d22868b412ca6d542d165e1143d4cde
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 27, 2025.
Transparency logRelease files / climax_rfglab-2025.10.6-cp310-abi3-manylinux_2_28_x86_64.whl
| Download URL | climax_rfglab-2025.10.6-cp310-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 319.3 kB |
| Tags | CPython 3.10 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
aa23e7377d2158c4f7633a1ec1c1f8eee682d3dfc47b3c64390ad124f8703130
|
|
BLAKE2b-256 checksum How to use checksums |
931409fca33f7fa93da4d6ff0b192765abfae07ae6c5613ed571abc0d38501f4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 27, 2025.
Transparency logRelease files / climax_rfglab-2025.10.6-cp310-abi3-macosx_11_0_arm64.whl
| Download URL | climax_rfglab-2025.10.6-cp310-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 282.1 kB |
| Tags | CPython 3.10 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
d5407a9ce64ff13aab073bc7f473321f30e910075198692791a6bca5f6bf4926
|
|
BLAKE2b-256 checksum How to use checksums |
3d9d710ba67f96425b0ad064d82b3943765a04c4240c016808b5896b8f919d0e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 27, 2025.
Transparency logRelease files / climax_rfglab-2025.10.6-cp310-abi3-macosx_10_12_x86_64.whl
| Download URL | climax_rfglab-2025.10.6-cp310-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 295.1 kB |
| Tags | CPython 3.10 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
bc2268fde26b8f304b13b5562666bd141558a5b6bff4416ceec3444a16969c33
|
|
BLAKE2b-256 checksum How to use checksums |
6702c423c8cdbd58029d829c6ee2ad394664f6271369121365f95ac5b3918045
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 27, 2025.
Transparency log
