Metadata-Version: 2.4
Name: membrane-kymograph
Version: 0.0.7
Summary: A GUI-based cross-platform tool for generating membrane kymographs from live-cell time-lapse microscopy images
Home-page: https://github.com/tatsatb/membrane-kymograph-generator
Download-URL: https://github.com/tatsatb/membrane-kymograph-generator/releases/latest
Author: Tatsat Banerjee
License: GPL-3.0-or-later
Project-URL: Bug Reports, https://github.com/tatsatb/membrane-kymograph-generator/issues
Project-URL: Source, https://github.com/tatsatb/membrane-kymograph-generator
Keywords: microscopy kymograph cell-biology fluorescence image-processing membrane-dynamics
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Scientific/Engineering :: Image Processing
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10,<3.14
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: circle-fit==0.2.1
Requires-Dist: contourpy==1.3.2
Requires-Dist: cycler==0.12.1
Requires-Dist: et_xmlfile==2.0.0
Requires-Dist: fonttools==4.60.1
Requires-Dist: future==1.0.0
Requires-Dist: imageio==2.37.0
Requires-Dist: joblib==1.5.2
Requires-Dist: kiwisolver==1.4.9
Requires-Dist: lazy_loader==0.4
Requires-Dist: matplotlib==3.10.7
Requires-Dist: networkx==3.4.2
Requires-Dist: numpy==2.2.6
Requires-Dist: opencv-python==4.12.0.88
Requires-Dist: openpyxl==3.1.5
Requires-Dist: packaging==25.0
Requires-Dist: pandas==2.3.3
Requires-Dist: patsy==1.0.2
Requires-Dist: pillow==11.3.0
Requires-Dist: pyparsing==3.2.5
Requires-Dist: python-dateutil==2.9.0.post0
Requires-Dist: pytz==2025.2
Requires-Dist: scikit-image==0.25.2
Requires-Dist: scikit-learn==1.7.2
Requires-Dist: scipy==1.15.3
Requires-Dist: seaborn==0.13.2
Requires-Dist: shapely==2.1.2
Requires-Dist: six==1.17.0
Requires-Dist: statsmodels==0.14.5
Requires-Dist: threadpoolctl==3.6.0
Requires-Dist: tifffile==2025.5.10
Requires-Dist: tiffile==2018.10.18
Requires-Dist: ttkbootstrap==1.16.0
Requires-Dist: tzdata==2025.2
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: black>=22.0; extra == "dev"
Requires-Dist: flake8>=5.0; extra == "dev"
Requires-Dist: mypy>=1.0; extra == "dev"
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: download-url
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Membrane Kymograph Generator


<p align="center">
<img src="https://raw.githubusercontent.com/tatsatb/membrane-kymograph-generator/233f5c6074246d4c9a667ca47ee3ee1140c5786c/icons/ICON.svg" width="280" alt="Membrane Kymograph Generator Icon">
<br/><br/>
</p>


---

# ✅ 📚 Please visit the [Wiki](https://github.com/tatsatb/membrane-kymograph-generator/wiki/) for detailed documentation. 

---

## ✨ Overview


[![DOI](https://img.shields.io/badge/DOI-10.64898%2F2026.02.11.705379-bd2736?style=for-the-badge)](https://doi.org/10.64898/2026.02.11.705379)
[![GitHub Release](https://img.shields.io/github/v/release/tatsatb/membrane-kymograph-generator?style=for-the-badge&color=blueviolet)](https://github.com/tatsatb/membrane-kymograph-generator/releases)
[![Documentation](https://img.shields.io/badge/Wiki-Documentation-forestgreen?style=for-the-badge&logo=read-the-docs&logoColor=white)](https://github.com/tatsatb/membrane-kymograph-generator/wiki)
[![PyPI](https://img.shields.io/pypi/v/membrane-kymograph?style=for-the-badge&color=blue&logo=python&logoColor=white)](https://pypi.org/project/membrane-kymograph/)
[![License](https://img.shields.io/github/license/tatsatb/membrane-kymograph-generator?style=for-the-badge&color=red)](https://github.com/tatsatb/membrane-kymograph-generator/blob/main/LICENSE)
[![Tests](https://img.shields.io/github/actions/workflow/status/tatsatb/membrane-kymograph-generator/tests.yml?label=Tests&style=for-the-badge)](https://github.com/tatsatb/membrane-kymograph-generator/actions/workflows/tests.yml)



_Membrane Kymograph Generator_, is a cross-platform, free and open-source, GUI-based application for generating kymographs from live-cell microscopy images along dynamic cell boundaries. Starting from a time-lapse image sequence and a whole cell binary mask, it automatically extracts the boundaries, corrects for the changes in the shape and size of the boundaries (using a custom algorithm), properly aligns the boundaries between different frames, samples intensities across the boundaries, and finally generates publication-quality kymographs in various formats. It also provides a built-in correlation analysis tool, options for customizations and downstream analyses, and a native Python API for advanced users.

---

## 🚀 Quick Start

**[Download the latest release](https://github.com/tatsatb/membrane-kymograph-generator/releases)** and check out the **[Quick Start Guide](https://github.com/tatsatb/membrane-kymograph-generator/wiki/QuickStart)** to begin generating kymographs in minutes!

**No Python installation, dependency management, or programming knowledge is required - just download, install (or extract, if you are using portable binaries), and run!**

---

## 🎁 Out of the box features

- **User-Friendly GUI**: An intuitive, interactive interface built with ttkbootstrap which allows easy navigation and parameter adjustments. 
- **Robust Input Validation**: TIFF format checking and dimension compatibility verification. 
- **Flexible Output Formats**: Save kymographs as PNG, SVG, and/or PDF
- **Multi-Channel Support**: Process multiple fluorescence channels simultaneously. 
- **Efficient Processing**:
  - Automatic boundary detection and smoothing via custom rotational offset algorithm. 
  - Circle fitting for perpendicular line generation
  - LOWESS smoothing for intensity profiles
  - Parallel processing via `joblib` for improved performance
- **Comprehensive Data Export**:
  - NumPy arrays (.npy) for all intermediate data
  - Excel files (.xlsx) for centroid positions and kymograph data
  - High-quality vector and raster visualizations
- **Interactive Post-Processing**: 
  - Fine-tune color limits after processing
  - Built-in correlation analysis tool (and statistical tests) for kymograph data
- **Native Python API**: For advanced users to enable batch processing (of large-scale datasets) and custom downstream spatiotemporal analyses (examples are provided in the [Wiki](https://github.com/tatsatb/membrane-kymograph-generator/wiki/Advanced-Usage:-Python-API)).
- **Cross-Platform Compatibility**: Available for both x86-64 and ARM64 systems running either Windows, macOS, and any standard Linux distribution. No installation of Python or any dependencies required. 

- **Open Source**: Free and open-source under the GPL v3 License.

---

## 🔗 Links


- 🔽 To download the latest version of the software, please visit the [Releases](https://github.com/tatsatb/membrane-kymograph-generator/releases).

- 📄 To learn more about the features, capabilities, and inner workings of the software, please read the [Preprint](https://doi.org/10.64898/2026.02.11.705379 ).

- 📚 For detailed documentation on how to use this software, please visit the [wiki](https://github.com/tatsatb/membrane-kymograph-generator/wiki/Home). 

- 💻 To access the source code, report issues, or contribute to the development of the software, please visit the [GitHub repository](https://github.com/tatsatb/membrane-kymograph-generator).

- 🐞 To report issues or request features, please use the [GitHub Issues](https://github.com/tatsatb/membrane-kymograph-generator/issues) page.


---

## 📖 Citation

If you use this software in your research, please cite the following preprint:


> Tatsat Banerjee, Bedri Abubaker-Sharif, Peter N Devreotes, Pablo A Iglesias. "Membrane Kymograph Generator: A cross-platform GUI software for automated generation and analysis of kymographs along dynamic cell boundaries", bioRxiv, 2026, 2026.02.11.705379. DOI: [10.64898/2026.02.11.705379](https://doi.org/10.64898/2026.02.11.705379).

---

## 🙏 Acknowledgments

Developed at the Iglesias Lab and Devreotes Lab at Johns Hopkins University for analyzing membrane dynamics in dynamic cell physiological processes. We thank all the members of both labs for their valuable feedback during the development and testing phases. For more details on the acknowledgments, please see the [Preprint](https://doi.org/10.64898/2026.02.11.705379). 


---

## ⚖️ License

Copyright © 2025 Tatsat Banerjee, Bedri Abubaker-Sharif, Peter N. Devreotes, and Pablo A. Iglesias.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>. 
