.. image:: https://raw.githubusercontent.com/teese/eccpy/master/docs/logo/ECCpy_logo.png :height: 200px :width: 600 px :scale: 50 %

ECCpy, a program for EC50 calculation in python.

The EC50, or the "half maximal effective concentration", is a key measure of the effectiveness of a compound to affect a biological system. It is commonly used in pharmacology, biology and biochemistry. The EC50 is calculated by fitting the dose-response data to a sigmoidal curve, typically using the Hill equation. Variants include the half maximal "lethal dose" (LD50), and "inhibitor concentration" (IC50).

Features

Robust data analysis ....................

• fully automated

  • fitting of sigmoidal curves to dose-response data
  • calculation of EC50, LD50 or IC50 values.
  • high-throughput analysis
  • comparison of EC50 values from different experiments
  • calculation of EC25 or EC75 values

• accepts REAL biological data

  • pre-filtering excludes nonsense data
  • judgefit module identifies low-quality EC50 values

Designed for humans ....................

• easy-to-use excel files:

  • excel settings file
  • excel input file with dose and response data
  • excel output file with EC50 values

• simple graphical output:

  • sigmoidal curves with EC50 shown on graph
  • daily summary barcharts and curves

Customisable ............

• simple python syntax
• open-source software
• built on powerful numpy, scipy, and pandas packages

Development status

ECCpy has been used extensively for the analysis of LD50 assays by bachelor, master and PhD students within the lab of Dieter Langosch at the Technical University of Munich in Germany. However this software is released "as is", and may contain bugs related to particular data types, python versions or operating systems.

Installation

As described in the wiki <https://github.com/teese/eccpy/wiki>, ECCpy was originally developed for Anaconda 2020.7 and python 3.8. Until the code is updated to a later version of python, it's strongly recommended to install ECCpy into a dedicated virtual environment <https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#creating-an-environment-with-commands> with python 3.8 and install the exact package versions specified in the requirements.txt <https://github.com/teese/eccpy/tree/develop/requirements.txt>_.

Example using conda, based on the Anaconda python distribution <https://www.anaconda.com/products/individual>_ or Miniforge <https://github.com/conda-forge/miniforge>_:

::

conda create -n eccpy python=3.8
conda activate eccpy
git clone [email protected]:teese/eccpy.git
cd eccpy
pip install -r requirements.txt
pip install --editable .

:code:pip install eccpy might also still work, so long as it's in an environment with python 3.8

Test that ECCpy is working

• After downloading ECCpy from github, run :code:python -m pytest --disable-warnings in the ECCpy repository directory to automatically start tests. The tests should all pass, with some deprecation warnings.
• before processing your own data, run eccpy on the provided example files provided, following the instructions in the ECCpy wiki <https://github.com/teese/eccpy/wiki>_.
• example data is available in eccpy/examples/example_data <https://github.com/teese/eccpy/tree/develop/eccpy/examples/example_data>_
• example settings are available in eccpy/examples/example_settings <https://github.com/teese/eccpy/tree/develop/eccpy/examples/example_settings>_

Usage

As described in the wiki <https://github.com/teese/eccpy/wiki>_, ECCpy requires only the following three steps:

1) Prepare your data.

• use the excel or microplate templates in the eccpy/templates folder
• for the generic excel format, simply open the template and paste in your dose and response data.

2) Update an excel settings file

• copy the ECCpy_settings_template.xlsx from eccpy/templates
• open the excel file, input the name and location of your datafiles, and the desired location for your output files
• write "TRUE" next to the files you want to examine

.. image:: https://raw.githubusercontent.com/teese/eccpy/master/docs/images/01_run_curvefit_settings.png :height: 120px :width: 700px

3) Run ECCpy

• run the ipython/jupyter notebook, which opens a python interpreter in your web browser
• paste in the following four lines. Replace the location of your settings file.
• hit Ctrl-Enter to run
• based on your output, adjust the quality thresholds in the settings file to suit your data

Example ::

import eccpy
settings = r"D:\data\ECCpy_settings.xlsx"
eccpy.run_curvefit(settings)
eccpy.run_gatherer(settings)

ECCpy output

run_curvefit program

• individual dose-response curves
• automatic judging of data quality
• daily summary curves, barchart and more!

.. image:: https://raw.githubusercontent.com/teese/eccpy/master/docs/images/curve_fit_output_sample3.png :height: 300px :width: 900px

.. image:: https://raw.githubusercontent.com/teese/eccpy/master/docs/images/generated_data_0EC50_analysis_fig.png :height: 500px :width: 500px

run_gatherer program

• combines data from multiple experiments
• excludes EC50 values that are not of sufficient quality, according to user-defined thresholds
• bar charts with mean and SEM over all selected experiments
• scatter plots showing individual datapoints for each day/experiment, and more!

compare_rawdata program

• collects raw data and dose-response curves from multiple experiments
• compares datapoints and fitted curves between the selected samples

.. image:: https://raw.githubusercontent.com/teese/eccpy/master/docs/images/20160527_0_compare_raw.png :height: 600px :width: 700px

Tutorial video

You can also check out a "how to install and run ECCpy" video by following the link below:

https://www.youtube.com/watch?v=H-cRd3-vKVg

License

ECCpy is free software distributed under the permissive MIT license.

Releases

Release-notes are found in /docs/releases.rst <https://github.com/teese/eccpy/tree/develop/docs/releases.rst>_

Citation

If you use ECCpy in your research, please use the following citation.

Schanzenbach C, Schmidt FC, Breckner P, Teese MG, & Langosch D (2017) Identifying ionic interactions within a membrane using BLaTM, a genetic tool to measure homo-and heterotypic transmembrane helix-helix interactions. Scientific Reports 7(7):43476.

https://www.ncbi.nlm.nih.gov/pubmed/28266525

Contact, Support, and Contribute

ECCpy needs you!

ECCpy was developed by Mark Teese during his postdoc at the Langosch lab <http://cbp.wzw.tum.de/index.php?id=9>_ of the Technical University of Munich. However, since then, Professor Langosch has retired, and the the software is no longer under active development.

Please contact Mark at the email address below if you're interested in helping develop or maintain ECCpy.

.. image:: https://raw.githubusercontent.com/teese/eccpy/develop/docs/images/signac_setting_sun.png :scale: 50%