{"id":20956542,"url":"https://github.com/bluebrain/diameter-synthesis","last_synced_at":"2025-05-14T05:32:02.314Z","repository":{"id":37449251,"uuid":"378876504","full_name":"BlueBrain/diameter-synthesis","owner":"BlueBrain","description":"Synthesize diameters of neuronal morphologies","archived":false,"fork":false,"pushed_at":"2024-11-06T13:27:08.000Z","size":5779,"stargazers_count":3,"open_issues_count":1,"forks_count":2,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-11-13T01:02:58.695Z","etag":null,"topics":["morphology","neuroscience"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BlueBrain.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-21T09:27:22.000Z","updated_at":"2024-11-06T13:26:52.000Z","dependencies_parsed_at":"2022-07-09T09:30:20.454Z","dependency_job_id":"f30a961a-e3bf-44a3-b0c6-0ae827eda9db","html_url":"https://github.com/BlueBrain/diameter-synthesis","commit_stats":{"total_commits":178,"total_committers":8,"mean_commits":22.25,"dds":0.3146067415730337,"last_synced_commit":"c34ffff842c6fb2737f5ba2b122c688dad2e5ad2"},"previous_names":[],"tags_count":67,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlueBrain%2Fdiameter-synthesis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlueBrain%2Fdiameter-synthesis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlueBrain%2Fdiameter-synthesis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlueBrain%2Fdiameter-synthesis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BlueBrain","download_url":"https://codeload.github.com/BlueBrain/diameter-synthesis/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225277114,"owners_count":17448626,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["morphology","neuroscience"],"created_at":"2024-11-19T01:26:36.502Z","updated_at":"2025-05-14T05:32:02.303Z","avatar_url":"https://github.com/BlueBrain.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003e [!WARNING]\n\u003e The Blue Brain Project concluded in December 2024, so development has ceased under the BlueBrain GitHub organization.\n\u003e Future development will take place at: https://github.com/openbraininstitute/diameter-synthesis\n\n[![Version](https://img.shields.io/pypi/v/diameter-synthesis)](https://github.com/BlueBrain/diameter-synthesis/releases)\n[![Build status](https://github.com/BlueBrain/diameter-synthesis/actions/workflows/run-tox.yml/badge.svg?branch=main)](https://github.com/BlueBrain/diameter-synthesis/actions)\n[![Codecov.io](https://codecov.io/github/BlueBrain/diameter-synthesis/coverage.svg?branch=main)](https://codecov.io/github/BlueBrain/diameter-synthesis?branch=main)\n[![License](https://img.shields.io/badge/License-GPLv3-blue)](https://github.com/BlueBrain/diameter-synthesis/blob/main/LICENSE.txt)\n[![Documentation status](https://readthedocs.org/projects/diameter-synthesis/badge/?version=latest)](https://diameter-synthesis.readthedocs.io/)\n[![DOI](https://img.shields.io/badge/DOI-10.1016/j.celrep.2022.110586-blue)](https://doi.org/10.1016/j.celrep.2022.110586)\n\n\n# Diameter synthesis\n\nThis code aims at generating synthetic diameters for neurons, with parameters learned from a set of biological neurons.\n\n\n## Installation\n\nUse pip:\n\n```bash\npip install diameter-synthesis\n```\n\n## Main usage\n\n### Step 1: Building models\n\nIn folder `example`, you first have to modify `create_jsons.py` to suit your needs.\n\nYou have the following important parameters for the dict `extract_models_params`:\n\n- `morph_path`: path to morphology files\n- `mtypes_sort`: how to learn distributions: `all` to use all together, `mtypes` to use by mtypes , `super_mtypes` to use home made cells types (see `diameter_types` below)\n- `models`: to create several models (for now they are all the same, just different realisation of random numbers)\n- `neurite_types`: types of neurite to learn parameters for\n- `extra_params`: dict of additional model parameters\n\n### Step 2: Building diameters\n\nThen simply run `./run_models.sh` to create the models (saved in a json file).\n\nIn `create_jsons.py`, the dict `generate_diameters_params` needs to be updated, too, with entries matching the previous dict.\nThe path in `new_morph_path` will be where the new morphologies will be saved.\n\nThen run `./run_diamters.sh` to generate diameters.\n\n\n## Additional scripts\n\nSeveral additional scripts in folder `scripts`:\n\n- `diameter-checks`: run the diameter-check code (bluepymm) on the biological and sampled cells\n- `diameter_types`: cluster mtypes using distributions of surface areas (uses two privates repositories a the moment)\n- `extract_morphometrics`: from bio and sample cells, extracts and plot distribution of surface area and diameter as a function of branch order and path lengths\n- `extract_morphologies`: from a cell release, find the ones that can be run through diameter-check\n- `plot_morphologies`: plot all morphologies in mtype folders\n\n\n## Examples\n\nThe `examples` folder contains a simple example that will fetch morphologies from [neuromorpho.org](http://neuromorpho.org), learn a diameter model, rediametrize these morphologies, and perform some analysis of the results to compare original and diametrized morphologies.\nThis example can simply be run using the following command:\n```bash\n./run.sh\n```\n\n\n## Funding \u0026 Acknowledgment\n\nThe development of this software was supported by funding to the Blue Brain Project, a research center of the École polytechnique fédérale de Lausanne (EPFL), from the Swiss government’s ETH Board of the Swiss Federal Institutes of Technology.\n\nFor license and authors, see `LICENSE.txt` and `AUTHORS.md` respectively.\n\nCopyright © 2021-2022 Blue Brain Project/EPFL\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbluebrain%2Fdiameter-synthesis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbluebrain%2Fdiameter-synthesis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbluebrain%2Fdiameter-synthesis/lists"}