episcope

A tool for exploration of epigenetic datasets

Screen capture of the episcope tool, showing visualizations of four chromosomes from an experiment.

Prerequisites

• A recent (5.13+) version of ParaView

Installing

Create a python virtual environment with a Python version matching the pvpython version:

• Paraview 5.13 ships with Python 3.10.
• Paraview 6.0 ships with Python 3.12.

We will install the app and its dependencies in this virtual environment.

# Create the virtual environment (check the appropriate python version, see above)
python3 -m venv .venv --python=3.10

# Activate it
source .venv/bin/activate

# Install the app from PyPI
pip install episcope

# Deactivate the virtual environment
deactivate

Running

Finally, start the application using the pvpython already present on your machine

pvpython --venv .venv -m episcope.app --data /path/to/dataset

Development

Clone this repository and cd into it:

git clone git@github.com:epicsuite/episcope.git

# or if without ssh:
# git clone https://github.com/epicsuite/episcope.git

cd episcope

Follow the same instructions as above, with the exception that the episcope package should be installed from local source:

# Install the app in editable mode
pip install -e .

Command line arguments

List of optional command line arguments.

--num-quadrants | -n

Specify the number of 3D/2D quadrants in the app layout

--display-options | -o

Path to a file will be used to override the default appearance of the 3D visualization.

Example of a minimal display options file:

tube:
  Opacity: 0.5

delaunay:
  Opacity: 0.1

upper_gaussian_contour:
  Opacity: 0.8

lower_gaussian_contour:
  Opacity: 0.8

labels:
  color: [0, 1, 0]

spheres:
  color: [1, 0, 1]