FractalDNA
===
Python routines for generating geometric models of DNA
---
*FractalDNA is being converted to a package, it is under active developmemt*
<div align="center">
[](https://github.com/natl/fractaldna/actions?query=workflow%3Abuild)
[](https://pypi.org/project/fractaldna/)
[](https://github.com/natl/fractaldna/pulls?utf8=%E2%9C%93&q=is%3Apr%20author%3Aapp%2Fdependabot)
[](https://github.com/psf/black)
[](https://github.com/PyCQA/bandit)
[](https://github.com/natl/fractaldna/blob/master/.pre-commit-config.yaml)
[](https://github.com/natl/fractaldna/releases)
[](https://github.com/natl/fractaldna/blob/master/LICENSE)
</div>
FractalDNA is a Python package to make DNA geometries that can be joined together like
jigsaw puzzles. Both simple, sections of DNA and Solenoidal DNA can be built. This
module was built to enable DNA-level simulations to be run in [Geant4-DNA](http://geant4-dna.in2p3.fr/), part of the
[Geant4](geant4.cern.ch/) project.
Structure models define the large scale structure of DNA,
seeded from fractals. An example seeding fractal is below:
<p align="center">
<img width="460" height="300" src="https://raw.githubusercontent.com/natl/fractaldna/master/docs/source/images/fractal-path.svg" alt="A 3-D iterated Hilbert Curve">
</p>
DNA Models provide straight and curved segments that can come together to
make DNA for use in simulations.
<p align="center">
<img width="460" height="300" src="https://raw.githubusercontent.com/natl/fractaldna/master/docs/source/images/single_solenoid_line_plot.jpg" alt="A straight solenoidal DNA segment">
</p>
Project documentation is available [here](http://natl.github.io/fractaldna/) alongside [notebook examples](http://natl.github.io/fractaldna/examples.html)
## ⚙️ Installation
Install FractalDNA with `pip`
```bash
pip install fractaldna
```
or install with `Poetry`
```bash
poetry add fractaldna
```
## 🧬 Make some DNA
```py
from fractaldna.dna_models import dnachain as dna
# Make a DNA Chain 40 base pairs long (repeating GATC).
chain = dna.DNAChain("GTAC" * 10)
# Export it to a DataFrame for use in another program
df = chain.to_frame()
```
For more, check out the [notebook examples](http://natl.github.io/fractaldna/examples.html) in the project documentation.
## 🛡 License
[](https://github.com/natl/fractaldna/blob/master/LICENSE)
This project is licensed under the terms of the `MIT` license. See [LICENSE](https://github.com/natl/fractaldna/blob/master/LICENSE) for more details.
## 📃 Citation
```bibtex
@misc{fractaldna,
author = {Nathanael Lampe},
title = {FractalDNA},
year = {2021},
publisher = {GitHub},
journal = {GitHub repository},
howpublished = {\url{https://github.com/natl/fractaldna}}
}
```
## Credits [](https://github.com/TezRomacH/python-package-template)
This project was generated with [`python-package-template`](https://github.com/TezRomacH/python-package-template)
Raw data
{
"_id": null,
"home_page": "https://github.com/natl/fractaldna",
"name": "fractaldna",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<3.11",
"maintainer_email": "",
"keywords": "dna,geant4,simulation,modelling",
"author": "Nathanael Lampe",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/9d/b5/d82b093539ef560d7853364ad2deebde58e9c25290989d46b75a4ef65760/fractaldna-0.6.1.tar.gz",
"platform": null,
"description": "FractalDNA\n===\nPython routines for generating geometric models of DNA\n---\n\n*FractalDNA is being converted to a package, it is under active developmemt*\n\n<div align=\"center\">\n\n[](https://github.com/natl/fractaldna/actions?query=workflow%3Abuild)\n[](https://pypi.org/project/fractaldna/)\n[](https://github.com/natl/fractaldna/pulls?utf8=%E2%9C%93&q=is%3Apr%20author%3Aapp%2Fdependabot)\n\n[](https://github.com/psf/black)\n[](https://github.com/PyCQA/bandit)\n[](https://github.com/natl/fractaldna/blob/master/.pre-commit-config.yaml)\n[](https://github.com/natl/fractaldna/releases)\n[](https://github.com/natl/fractaldna/blob/master/LICENSE)\n\n</div>\n\nFractalDNA is a Python package to make DNA geometries that can be joined together like\njigsaw puzzles. Both simple, sections of DNA and Solenoidal DNA can be built. This\nmodule was built to enable DNA-level simulations to be run in [Geant4-DNA](http://geant4-dna.in2p3.fr/), part of the\n[Geant4](geant4.cern.ch/) project.\n\nStructure models define the large scale structure of DNA,\nseeded from fractals. An example seeding fractal is below:\n\n<p align=\"center\">\n <img width=\"460\" height=\"300\" src=\"https://raw.githubusercontent.com/natl/fractaldna/master/docs/source/images/fractal-path.svg\" alt=\"A 3-D iterated Hilbert Curve\">\n</p>\n\nDNA Models provide straight and curved segments that can come together to\nmake DNA for use in simulations.\n\n<p align=\"center\">\n <img width=\"460\" height=\"300\" src=\"https://raw.githubusercontent.com/natl/fractaldna/master/docs/source/images/single_solenoid_line_plot.jpg\" alt=\"A straight solenoidal DNA segment\">\n</p>\n\nProject documentation is available [here](http://natl.github.io/fractaldna/) alongside [notebook examples](http://natl.github.io/fractaldna/examples.html)\n\n## \u2699\ufe0f Installation\n\nInstall FractalDNA with `pip`\n\n```bash\npip install fractaldna\n```\n\nor install with `Poetry`\n\n```bash\npoetry add fractaldna\n```\n\n## \ud83e\uddec Make some DNA\n\n```py\nfrom fractaldna.dna_models import dnachain as dna\n\n# Make a DNA Chain 40 base pairs long (repeating GATC).\nchain = dna.DNAChain(\"GTAC\" * 10)\n\n# Export it to a DataFrame for use in another program\ndf = chain.to_frame()\n```\n\nFor more, check out the [notebook examples](http://natl.github.io/fractaldna/examples.html) in the project documentation.\n\n## \ud83d\udee1 License\n\n[](https://github.com/natl/fractaldna/blob/master/LICENSE)\n\nThis project is licensed under the terms of the `MIT` license. See [LICENSE](https://github.com/natl/fractaldna/blob/master/LICENSE) for more details.\n\n## \ud83d\udcc3 Citation\n\n```bibtex\n@misc{fractaldna,\n author = {Nathanael Lampe},\n title = {FractalDNA},\n year = {2021},\n publisher = {GitHub},\n journal = {GitHub repository},\n howpublished = {\\url{https://github.com/natl/fractaldna}}\n}\n```\n\n## Credits [](https://github.com/TezRomacH/python-package-template)\n\nThis project was generated with [`python-package-template`](https://github.com/TezRomacH/python-package-template)",
"bugtrack_url": null,
"license": "MIT",
"summary": "FractalDNA is a Python package built to generate DNA geometries for simulations",
"version": "0.6.1",
"project_urls": {
"Documentation": "https://natl.github.io/fractaldna",
"Homepage": "https://github.com/natl/fractaldna",
"Repository": "https://github.com/natl/fractaldna"
},
"split_keywords": [
"dna",
"geant4",
"simulation",
"modelling"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c77bcf3047e9afbea5d19700cf3f5f01fd6501f4bcd74d60e6c0d1a361c7bea5",
"md5": "33f3374da76f2f8e5a32a2a6e97eafc3",
"sha256": "8fa308e77099f6f62c06fd84ff7ff4042887b8c010f643570f3c83494387623c"
},
"downloads": -1,
"filename": "fractaldna-0.6.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "33f3374da76f2f8e5a32a2a6e97eafc3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<3.11",
"size": 46942,
"upload_time": "2023-05-09T23:50:23",
"upload_time_iso_8601": "2023-05-09T23:50:23.331864Z",
"url": "https://files.pythonhosted.org/packages/c7/7b/cf3047e9afbea5d19700cf3f5f01fd6501f4bcd74d60e6c0d1a361c7bea5/fractaldna-0.6.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9db5d82b093539ef560d7853364ad2deebde58e9c25290989d46b75a4ef65760",
"md5": "30fd4b0dcd847e8d0a4e04ff35474bc2",
"sha256": "d1e97098cfc7c616cf4623f65678ae4ead17a538cb7bbd1a2394fbf5b8f08e50"
},
"downloads": -1,
"filename": "fractaldna-0.6.1.tar.gz",
"has_sig": false,
"md5_digest": "30fd4b0dcd847e8d0a4e04ff35474bc2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<3.11",
"size": 44306,
"upload_time": "2023-05-09T23:50:25",
"upload_time_iso_8601": "2023-05-09T23:50:25.866308Z",
"url": "https://files.pythonhosted.org/packages/9d/b5/d82b093539ef560d7853364ad2deebde58e9c25290989d46b75a4ef65760/fractaldna-0.6.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-09 23:50:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "natl",
"github_project": "fractaldna",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "click",
"specs": [
[
"==",
"8.1.3"
]
]
},
{
"name": "colorama",
"specs": [
[
"==",
"0.4.6"
]
]
},
{
"name": "commonmark",
"specs": [
[
"==",
"0.9.1"
]
]
},
{
"name": "contourpy",
"specs": [
[
"==",
"1.0.7"
]
]
},
{
"name": "cycler",
"specs": [
[
"==",
"0.11.0"
]
]
},
{
"name": "fonttools",
"specs": [
[
"==",
"4.39.3"
]
]
},
{
"name": "importlib-metadata",
"specs": [
[
"==",
"4.13.0"
]
]
},
{
"name": "importlib-resources",
"specs": [
[
"==",
"5.12.0"
]
]
},
{
"name": "kiwisolver",
"specs": [
[
"==",
"1.4.4"
]
]
},
{
"name": "matplotlib",
"specs": [
[
"==",
"3.7.1"
]
]
},
{
"name": "numpy",
"specs": [
[
"==",
"1.24.3"
]
]
},
{
"name": "packaging",
"specs": [
[
"==",
"21.3"
]
]
},
{
"name": "pandas",
"specs": [
[
"==",
"1.5.3"
]
]
},
{
"name": "pillow",
"specs": [
[
"==",
"9.5.0"
]
]
},
{
"name": "pygments",
"specs": [
[
"==",
"2.15.1"
]
]
},
{
"name": "pyparsing",
"specs": [
[
"==",
"3.0.9"
]
]
},
{
"name": "python-dateutil",
"specs": [
[
"==",
"2.8.2"
]
]
},
{
"name": "pytz",
"specs": [
[
"==",
"2023.3"
]
]
},
{
"name": "rich",
"specs": [
[
"==",
"12.6.0"
]
]
},
{
"name": "scipy",
"specs": [
[
"==",
"1.10.1"
]
]
},
{
"name": "setuptools-scm",
"specs": [
[
"==",
"7.1.0"
]
]
},
{
"name": "shellingham",
"specs": [
[
"==",
"1.5.1"
]
]
},
{
"name": "six",
"specs": [
[
"==",
"1.16.0"
]
]
},
{
"name": "tomli",
"specs": [
[
"==",
"2.0.1"
]
]
},
{
"name": "tqdm",
"specs": [
[
"==",
"4.65.0"
]
]
},
{
"name": "typer",
"specs": [
[
"==",
"0.4.2"
]
]
},
{
"name": "typing-extensions",
"specs": [
[
"==",
"4.5.0"
]
]
},
{
"name": "zipp",
"specs": [
[
"==",
"3.15.0"
]
]
}
],
"lcname": "fractaldna"
}
JSON
