Metadata-Version: 2.1
Name: Cellan
Version: 0.7.0
Summary: Analyze cell images.
Keywords: Image analysis,Cell detection and classification,Pixel analysis
Author-Email: Yujia Hu <yujiahu415@gmail.com>
License: GPL-3.0
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Project-URL: Homepage, https://github.com/yujiahu415/Cellan
Requires-Python: >=3.9
Requires-Dist: numpy<=1.26.4
Requires-Dist: scipy
Requires-Dist: scikit-image
Requires-Dist: readlif
Requires-Dist: tifffile
Requires-Dist: imagecodecs
Requires-Dist: opencv-python
Requires-Dist: opencv-contrib-python
Requires-Dist: openpyxl
Requires-Dist: xlsxwriter
Requires-Dist: pandas
Requires-Dist: wxPython
Requires-Dist: packaging
Requires-Dist: requests
Requires-Dist: torch
Requires-Dist: torchvision
Requires-Dist: torchaudio
Requires-Dist: Pillow>=7.1
Requires-Dist: matplotlib
Requires-Dist: pycocotools>=2.0.2
Requires-Dist: termcolor>=1.1
Requires-Dist: yacs>=0.1.8
Requires-Dist: tabulate
Requires-Dist: cloudpickle
Requires-Dist: tqdm>4.29.0
Requires-Dist: tensorboard
Requires-Dist: fvcore<0.1.6,>=0.1.5
Requires-Dist: iopath>=0.1.7
Requires-Dist: dataclasses; python_version < "3.7"
Requires-Dist: omegaconf<2.4,>=2.1
Requires-Dist: hydra-core>=1.1
Requires-Dist: black
Requires-Dist: ninja
Requires-Dist: six
Description-Content-Type: text/markdown

# Cellan: Analyze cell images.

[![PyPI - Version](https://img.shields.io/pypi/v/Cellan)](https://pypi.org/project/Cellan/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/Cellan)](https://pypi.org/project/Cellan/)
[![Downloads](https://static.pepy.tech/badge/Cellan)](https://pepy.tech/project/Cellan)

<p>&nbsp;</p>

## Installation

<p>&nbsp;</p>

Cellan works for Windows, Mac and Linux systems. Installation steps can vary for different systems. But in general, you need to:
1) Install Python3 (>=3.9)
2) If using an NVIDIA GPU, set up CUDA (v11.8) and install PyTorch with cu118 support.
3) Install Cellan with pip

Below is the guide for Windows.

1. Install Python3, for example, [Python 3.12](https://www.python.org/downloads/release/python-31210/).

   Scroll down to the bottom and click the `Windows installer (64-bit)` option. Run the installer and select 'Add python to path' and 'Disable long path limit'.

2. If you're using an NVIDIA GPU, install CUDA Toolkit 11.8 and cuDNN, and install PyTorch with cu118 support.

   First, Install [CUDA Toolkit 11.8](https://developer.nvidia.com/cuda-11-8-0-download-archive?target_os=Windows&target_arch=x86_64). Select your version of Windows, select "exe (local)," then click "Download."

   To verify your installation of CUDA, use the following command.

   ```pwsh-session
   set CUDA_HOME=%CUDA_HOME_V11_8%
   ```
   ```pwsh-session
   nvcc --version
   ```

   Next, install [cuDNN](https://developer.nvidia.com/rdp/cudnn-archive). You will need to register an NVIDIA Developer account, which you can do for free. You can choose cuDNN v8.9.7 that supports CUDA toolkit v11.8. Choose 'Local Installer for Windows (Zip)', download and extract it. And then copy the three folders 'bin', 'lib', and 'include' into where the CUDA toolkit is installed (typcially, 'C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v11.8\'), and replace all the three folders with the same names. After that, you may need to add the 'C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v11.8' to path via environmental variables.

   Finally, install PyTorch with cu118 support.

   ```pwsh-session
   py -3.12 -m pip install torch==2.5.1 torchvision==0.20.1 torchaudio==2.5.1 --index-url https://download.pytorch.org/whl/cu118
   ```

3. Upgrade `pip`, `wheel`, `setuptools`.
   
   ```pwsh-session
   py -3.12 -m pip install --upgrade pip wheel setuptools
   ```

4. Install Cellan via `pip`.
   
   ```pwsh-session
   py -3.12 -m pip install Cellan
   ```

Launch Cellan:

   ```pwsh-session
   Cellan
   ```

   If this doesn't work, which typically is because the python3/script is not in your environment path. You can google 'add python3 script to path environmental variable in windows' to add it to path, or simply use the following commands to initiate Cellan:

   ```pwsh-session
   py -3.12
   ```
   ```pwsh-session
   from Cellan import __main__
   ```
   ```pwsh-session
   __main__.main()
   ```

