{"id":34056743,"url":"https://github.com/modsim/molyso","last_synced_at":"2026-03-17T20:37:07.017Z","repository":{"id":21532386,"uuid":"24851674","full_name":"modsim/molyso","owner":"modsim","description":"molyso - Mother Machine Analysis Software","archived":false,"fork":false,"pushed_at":"2021-03-06T00:59:16.000Z","size":4464,"stargazers_count":10,"open_issues_count":3,"forks_count":3,"subscribers_count":7,"default_branch":"main","last_synced_at":"2026-02-21T17:31:01.422Z","etag":null,"topics":["bioinformatics","image-analysis","microfluidics","mother-machine","python"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/modsim.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.rst","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-10-06T15:30:08.000Z","updated_at":"2025-01-30T21:35:13.000Z","dependencies_parsed_at":"2022-08-21T02:50:08.018Z","dependency_job_id":null,"html_url":"https://github.com/modsim/molyso","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/modsim/molyso","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modsim%2Fmolyso","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modsim%2Fmolyso/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modsim%2Fmolyso/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modsim%2Fmolyso/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/modsim","download_url":"https://codeload.github.com/modsim/molyso/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modsim%2Fmolyso/sbom","scorecard":{"id":656074,"data":{"date":"2025-08-11","repo":{"name":"github.com/modsim/molyso","commit":"9ee9eaef5751e6e53c2673b62c94c8ddf5df692e"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.8,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":0,"reason":"Found 0/29 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE.rst:0","Info: FSF or OSI recognized license: BSD 2-Clause \"Simplified\" License: LICENSE.rst:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 2 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: containerImage not pinned by hash: Dockerfile:1: pin your Docker image by updating continuumio/miniconda3:4.9.2-alpine to continuumio/miniconda3:4.9.2-alpine@sha256:82bd96b0e95188e152d137f6c9834ea731bfc78e5c5f27b3c90f2be31e9e61d8","Info:   0 out of   1 containerImage dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}}]},"last_synced_at":"2025-08-21T14:39:59.157Z","repository_id":21532386,"created_at":"2025-08-21T14:39:59.157Z","updated_at":"2025-08-21T14:39:59.157Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30631403,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-17T17:32:55.572Z","status":"ssl_error","status_checked_at":"2026-03-17T17:32:38.732Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bioinformatics","image-analysis","microfluidics","mother-machine","python"],"created_at":"2025-12-14T03:02:57.171Z","updated_at":"2026-03-17T20:37:07.010Z","avatar_url":"https://github.com/modsim.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":".. image:: docs/_static/molyso-banner.png\n\nmolyso Readme\n=============\n\n.. image:: https://img.shields.io/pypi/v/molyso.svg\n   :target: https://pypi.python.org/pypi/molyso\n\n.. image:: https://img.shields.io/badge/docs-latest-brightgreen.svg?style=flat\n   :target: https://molyso.readthedocs.io/en/latest/\n\n.. image:: https://travis-ci.org/modsim/molyso.svg?branch=master\n   :target: https://travis-ci.org/modsim/molyso\n\n.. image:: https://img.shields.io/pypi/l/molyso.svg\n   :target: https://opensource.org/licenses/BSD-2-Clause\n\n.. image:: https://img.shields.io/docker/build/modsim/molyso.svg\n   :target: https://hub.docker.com/r/modsim/molyso\n\n.. image:: https://zenodo.org/badge/doi/10.5281/zenodo.53764.svg\n   :target: https://dx.doi.org/10.5281/zenodo.53764\n\n.. image:: https://zenodo.org/badge/doi/10.1371/journal.pone.0163453.svg\n   :target: https://dx.doi.org/10.1371/journal.pone.0163453\n   \n\nPublication\n-----------\nWhen using *molyso* for scientific applications, cite our publication:\n\n    Sachs CC, Grünberger A, Helfrich S, Probst C, Wiechert W, Kohlheyer D, Nöh K (2016)\n    Image-Based Single Cell Profiling:\n    High-Throughput Processing of Mother Machine Experiments.\n    PLoS ONE 11(9): e0163453. doi: 10.1371/journal.pone.0163453\n\nIt is available on the PLoS ONE homepage at `DOI: 10.1371/journal.pone.0163453 \u003chttps://dx.doi.org/10.1371/journal.pone.0163453\u003e`_\n\nExample Datasets\n----------------\nYou can find example datasets (as used in the publication) deposited at zenodo `DOI: 10.5281/zenodo.53764 \u003chttps://dx.doi.org/10.5281/zenodo.53764\u003e`_.\n\nDocumentation\n-------------\nDocumentation can be built using sphinx, but is available online as well at `Read the Docs \u003chttps://molyso.readthedocs.io/en/latest/\u003e`_.\n\nLicense\n-------\n*molyso* is free/libre open source software under the 2-clause BSD License. See :doc:`license`\n\nPrerequisites\n-------------\n*molyso* needs Python 3, if you don't have a Python installation or are not familiar with installing packages from source, it is suggested\nthat you use the `Anaconda \u003chttps://www.continuum.io/downloads\u003e`_ Python distribution, available for Windows, Linux and macOS.\n\nWays to install molyso\n----------------------\n\nThere are different ways to install molyso,\nfor ease of use it is suggested to use the Anaconda Python distribution and the conda package manager.\nAlternatively, you can use molyso inside a Docker container, see the Docker_ section near the end.\n\nWith Anaconda\n#############\n\n.. code-block:: bash\n\n    \u003e conda config --add channels conda-forge\n    \u003e conda config --add channels modsim\n\n    \u003e conda install -y molyso\n\n\nAlternatively, manually from github\n###################################\n\n.. code-block:: bash\n\n    \u003e git clone https://github.com/modsim/molyso\n    \u003e cd molyso\n    \u003e python setup.py install --user\n\nFirst Steps\n-----------\n*molyso* is packaged as a Python module, to run it, just use:\n\n.. code-block:: bash\n\n    \u003e python -m molyso\n\nAnd you will be greeted by the help screen of molyso:\n\n.. code-block:: none\n\n\n         \\   /\\  /\\  /                             -------------------------\n          | | |O| | |    molyso                    Developed  2013 - 2021 by\n          | | | | |O|                              Christian   C.  Sachs  at\n          |O| |O| |O|    MOther    machine         ModSim / Microscale Group\n          \\_/ \\_/ \\_/    anaLYsis SOftware         Research  Center  Juelich\n        --------------------------------------------------------------------\n        If you use this software in a publication, cite our paper:\n\n\n        Sachs CC, Grünberger A, Helfrich S, Probst C, Wiechert W, Kohlheyer D, Nöh K (2016)\n        Image-Based Single Cell Profiling:\n        High-Throughput Processing of Mother Machine Experiments.\n        PLoS ONE 11(9): e0163453. doi: 10.1371/journal.pone.0163453\n\n        --------------------------------------------------------------------\n\n    usage: __main__.py [-h] [-m MODULES] [-p] [-gt GROUND_TRUTH] [-ct CACHE_TOKEN]\n                       [-tp TIMEPOINTS] [-mp MULTIPOINTS] [-o TABLE_OUTPUT]\n                       [-ot TRACKING_OUTPUT] [-nb] [-cpu MP] [-debug] [-do] [-nci]\n                       [-cfi] [-ccb CHANNEL_BITS] [-cfb CHANNEL_FLUORESCENCE_BITS]\n                       [-q] [-nc [IGNORECACHE]] [-nt] [-t TUNABLES]\n                       [-s TUNABLE_LIST TUNABLE_LIST] [-pt] [-rt READ_TUNABLES]\n                       [-wt WRITE_TUNABLES]\n                       input\n\n    molyso: MOther machine anaLYsis SOftware\n\n    positional arguments:\n      input                 input file\n\n    optional arguments:\n      -h, --help            show this help message and exit\n      -m MODULES, --module MODULES\n      -p, --process\n      -gt GROUND_TRUTH, --ground-truth GROUND_TRUTH\n      -ct CACHE_TOKEN, --cache-token CACHE_TOKEN\n      -tp TIMEPOINTS, --timepoints TIMEPOINTS\n      -mp MULTIPOINTS, --multipoints MULTIPOINTS\n      -o TABLE_OUTPUT, --table-output TABLE_OUTPUT\n      -ot TRACKING_OUTPUT, --output-tracking TRACKING_OUTPUT\n      -nb, --no-banner\n      -cpu MP, --cpus MP\n      -debug, --debug\n      -do, --detect-once\n      -nci, --no-channel-images\n      -cfi, --channel-fluorescence-images\n      -ccb CHANNEL_BITS, --channel-image-channel-bits CHANNEL_BITS\n      -cfb CHANNEL_FLUORESCENCE_BITS, --channel-image-fluorescence-bits CHANNEL_FLUORESCENCE_BITS\n      -q, --quiet\n      -nc [IGNORECACHE], --no-cache [IGNORECACHE]\n      -nt, --no-tracking\n      -t TUNABLES, --tunables TUNABLES\n      -s TUNABLE_LIST TUNABLE_LIST, --set-tunable TUNABLE_LIST TUNABLE_LIST\n      -pt, --print-tunables\n      -rt READ_TUNABLES, --read-tunables READ_TUNABLES\n      -wt WRITE_TUNABLES, --write-tunables WRITE_TUNABLES\n\n    error: the following arguments are required: input\n\n\nThere are three modes of operation, batch processing, interactive viewer, and ground truth generation.\nThe most important part for routine use is batch processing, which will process a whole file or selected time/multi points and produce tabular output and/or tracking visualizations.\nThe interactive viewer can be used to show channel and cell detection on the given dataset, as a first step to check if the settings are applicable.\nThe ground truth viewer is more of a tool for verification of results, the kymograph of a preanalyzed dataset can be visualized *without* tracking, and individual cell generations can be marked manually, yielding a growth rate which can be compared to the automatic analysis.\n\nTo start the interactive viewer, just call molyso without any other parameters:\n\n.. code-block:: bash\n\n    \u003e python -m molyso dataset.ome.tiff\n\nTo start batch processing, run molyso with the :code:`-p` option. Give an output file for tabular output with :code:`-o` and/or an output directory for individual tracked kymographs with :code:`-ot`.\n\nNote: While OME-TIFF file contain calibration of time and voxel size, simple :code:`.tif` files may not,\nyou can tell molyso manually about the calibration by adding comma-delimited parameters after the file name (followed by a question mark):\nExample:\n\n.. code-block:: bash\n\n    \u003e python -m molyso \"filename.tif?interval=300,calibration=0.08\"\n\n\nSupported are among others: the acquisition :code:`interval` (seconds), and the pixel size :code:`calibration` in um per pixel.\nSome older files may have incorrectly labeled axes, since molyso expects the time axis to be correctly labeled, it might be necessary to reorder the axes, this can be done on the fly, by passing e.g. :code:`?swap_axes=Z..T`.\nDon't forget to escape/quote the ? in the command line.\n\n\n.. code-block:: bash\n\n    \u003e python -m molyso dataset.ome.tiff -p -o results.txt -ot dataset_tracking\n\n*molyso* writes cache files in the current directory which contain temporary analysis results. If you want to re-generate tabular output *e.g.*, those files will be read in and already performed analysis steps will be skipped. They are used as well, to show the kymograph for ground truth data mode. They can be kept if you plan any of the mentioned steps, if you are finished with an analysis, they can be deleted as well.\n\nOnce *molyso* has run, you will need to post-process the data to extract the information you're interested in.\nTake a look at the Jupyter/IPython Notebooks.\n\nDocker\n------\n\n`Docker \u003chttps://www.docker.com/\u003e`_ is a containerization platform allowing for applications to be run with bundled dependencies without explicit\ninstallation steps.\n\nYou can use the following commands to run molyso in lieu of the aforementioned calls, e.g. for analysis:\n\n.. code-block:: bash\n\n   \u003e docker run --tty --interactive --rm --volume \"`pwd`:/data\" --user `id -u` modsim/molyso -p \u003cparameters ...\u003e\n\nAnd to run interactive mode (display on local X11, under Linux):\n\n.. code-block:: bash\n\n   \u003e docker run --tty --interactive --rm --volume \"`pwd`:/data\" --user `id -u` --env DISPLAY=$DISPLAY --volume /tmp/.X11-unix:/tmp/.X11-unix modsim/molyso \u003cparameters ...\u003e\n\nDocker usage has just been tested with Linux host systems.\n\nThird Party Licenses\n--------------------\nNote that this software contains the following portions from other authors, under the following licenses (all BSD-flavoured):\n\nmolyso/generic/otsu.py:\n    functions threshold_otsu and histogram by the scikit-image team, licensed BSD (see file head).\n        Copyright (C) 2011, the scikit-image team\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmodsim%2Fmolyso","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmodsim%2Fmolyso","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmodsim%2Fmolyso/lists"}