context-explorer 1.1.2

A tool that facilitates analyses of data extracted from microscope images of cells

Thanks for stopping by! （ ^_^）o自自o（^_^ ）

# ContextExplorer

ContextExplorer facilitates analyses and visualization of data extracted from microscope images of cells.

## Relevance

The analyses methods in ContextExplorer focuses on how populations of cells are affected by their microenvironment, including local variations in cell signalling and cell density. It is currently difficult for scientists without previous programming experience to quantify these variables, although it is relevant for many research areas. Facilitating this type of analyses can help scientists around the world to improve their understanding of cellular behavior and accelerate their research.

## Overview


ContextExplorer is controlled via a graphical user interface and aims to enable powerful analysis and visualizations of single cell data extracted from microscope images for a broad scientific audience. ContextExplorer can work in tandem with many other tools since it only depends on a correctly formatted CSV-file as input and only outputs commonly used file formats (.csv, .jpg, .png, and .pdf)

## Installation

ContextExplorer can be installed via the package managers conda or pip, or via the source code on GitLab. The recommended way is to use conda. To get started, first download and install the [Anaconda Python distribution](https://www.anaconda.com/download/) (version 3.x). This will install Python together with common Python packages used for scientific computing and the conda package manager. Proceed to use conda from either the graphical program Anaconda Navigator or the command line:

### Anaconda Navigator

1. Open the Anaconda Navigator by searching for it in the start menu.

2. Click the Channels button and add “joelostblom” as a new channel.

3. Use the navigation pane on the left to switch to the Environments tab.

4. Change the dropdown meny from “installed” to “all” to see packages not yet installed on your system.

5. Search for “context-explorer”

6. Click the checkbox on the left and select “Mark for installation”.

7. Hit Apply in the bottom right corner and click through the dialog to install context-explorer.

8. To run the program, open the Anaconda Prompt from the start menu (or the terminal on OS X and Linux), type in ctexplorer and hit enter.

### Command line

1. If you are using Windows, open up the Anaconda Prompt from the start menu. On MacOS and Linux you can use your default terminal (e.g. terminal.app on MacOS) instead of the Anaconda Prompt.

2. Type conda install -c joelostblom context_explorer and press enter.

3. After the installation has finished, run the program by typing ctexplorer and hitting enter.

### Updates using conda

#### Anaconda Navigator

Click the same checkbox as during installation and select “Mark for update”, then hit apply in the bottom right corner.

#### Command line

conda update context_explorer

## Using ContextExplorer

If you are new to ContextExplorer, first download [the sample data](https://gitlab.com/stemcellbioengineering/context-explorer/raw/master/sample-data/ce-sample.csv) (right click link -> Save as). Launch ContextExplorer by typing ctexplorer in the terminal/Anaconda Prompt, then choose the sample file (or your own data) from the file selector. That’s all you need to start testing ContextExplorer!

Detailed documentation and workflow examples are available at the [documentation page](http://contextexplorer.readthedocs.io/en/latest/).

## Support

If you run into troubles, please [check the issue list](https://gitlab.com/stemcellbioengineering/context-explorer/issues) to see if your problem has already been reported. If not, open a new issue or [ask for help in the gitter chat](https://gitter.im/context_explorer/Lobby).

## Contributions

Feedback and suggestions are always welcome! This does not have to be code-related, don’t be shy =) Please read [the contributing guidelines](https://gitlab.com/joelostblom/context-explorer/blob/master/CONTRIBUTING.md) to get started.

## Roadmap

An overview of the projects direction is available in [the project wiki](https://gitlab.com/stemcellbioengineering/context-explorer/wikis/Roadmap).

## Code of conduct

Be welcoming, friendly, and patient; be direct and respectful; understand and learn from disagreement and different perspectives; lead by example; ask for help when unsure; give people the benefit of the doubt; a simple apology can go a long way; be considerate in the words that you choose. Detailed descriptions of these points can be found in [CODE_OF_CONDUCT.md](https://gitlab.com/stemcellbioengineering/context-explorer/blob/master/CODE_OF_CONDUCT.md).