Installation¶
Requirements¶
jetraw_tools requires Python 3.8 or later and depends on several scientific computing libraries:
numpy
nd2
ome-types
tifffile
typer
JetRaw libraries (for compression/decompression)
dpcore python libraries
Installing from PyPI¶
To install jetraw_tools from PyPI, use pip:
pip install jetraw_tools
Installing from Source¶
To install jetraw_tools latest version directly from the repository:
pip install git+https://github.com/phisanti/jetraw_tools.git
This will install the package in development mode, allowing you to make changes to the source code.
To install jetraw_tools from source:
git clone https://github.com/phisanti/jetraw_tools.git
cd jetraw_tools
pip install -e .
This will install the package in development mode, allowing you to make changes to the source code.
Dependencies¶
The main dependencies are automatically installed:
numpy: For numerical operations and array handling
nd2: For reading ND2 microscopy files
ome-types: For OME metadata handling
tifffile: For TIFF file I/O operations
typer: For command-line interface functionality
JetRaw C-libraries: For compression and decompression functionality (installed separately)
Environment Setup¶
It’s recommended to use a conda environment:
conda create -n jetraw_tools python=3.8
conda activate jetraw_tools
pip install git+https://github.com/phisanti/jetraw_tools.git
Verification¶
To verify the installation:
jetraw-tools --version
This should print the current version of jetraw_tools.
You can also verify in Python:
import jetraw_tools
print(jetraw_tools.__version__)
Initial Configuration¶
After installation, run the configuration wizard to set up your environment:
jetraw-tools settings
This will guide you through configuring:
Calibration file path
Camera identifiers
License key
JetRaw and DPCore installation paths