# TorchCNNBuilder
<div id="badges">
<a href="https://pytorch.org/">
<img src="https://img.shields.io/badge/pytorch-CB2C31?style=flat&logo=pytorch&logoColor=white" alt="pytorch badge"/>
</a>
<img alt="Dynamic JSON Badge" src="https://img.shields.io/pypi/pyversions/torch">
<a href="https://badge.fury.io/py/torchcnnbuilder">
<img src="https://badge.fury.io/py/torchcnnbuilder.svg" alt="PyPI version" height="18">
</a>
</div>
---
**TorchCNNBuilder** is an open-source framework for the automatic creation of CNN architectures. This framework should first of all help researchers in the applicability of CNN models for a huge range of tasks, taking over most of the writing of the architecture code. This framework is distributed under the 3-Clause BSD license. All the functionality is written only using `pytorch` *(no third-party dependencies)*
### Installation
---
The simplest way to install framework is using `pip`:
```
pip install torchcnnbuilder
```
### Usage examples
---
The basic structure of the framework is presented below. Each subdirectory has its own example of using the appropriate available functionality. You can check [`<directory>_examples.ipynb`](./examples) files in order to see the ways to use the proposed toolkit. In short, there is the following functionality:
- the ability to calculate the size of tensors after (transposed) convolutional layers
- preprocessing an n-dimensional time series in `TensorDataset`
- automatic creation of (transposed) convolutional sequences
- automatic creation of (transposed) convolutional layers and (transposed) blocks from convolutional layers
The structure of the main part of the package:
```
├── examples
│ ├── builder_examples.ipynb
│ ├── preprocess_examples.ipynb
│ ├── models_examples.ipynb
│ └── tools # additional functions for the examples
└── torchcnnbuilder
├── preprocess
│ └── time_series.py
├── builder.py
└── models.py
```
Initially, the library was created to help predict n-dimensional time series *(geodata)*, so there is a corresponding functionality and templates of predictive models *(like `ForecasterBase`)*
### Sources
---
- [Forecasting of Sea Ice Concentration using CNN, PDE discovery and Bayesian Networks](https://www.sciencedirect.com/science/article/pii/S1877050923020094)
- [Surrogate Modelling for Sea Ice Concentration using Lightweight Neural Ensemble](https://arxiv.org/abs/2312.04330)
Raw data
{
"_id": null,
"home_page": "https://github.com/ITMO-NSS-team/TorchCNNBuilder",
"name": "torchcnnbuilder",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "python torch cnn",
"author": "NSS Lab",
"author_email": "just.andrew.kd@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/18/0c/82364cae0e1b8b4b06a1b5750f95139c252835d5da288dabcc8a2409069a/torchcnnbuilder-0.0.19.tar.gz",
"platform": null,
"description": "# TorchCNNBuilder\n\n<div id=\"badges\">\n <a href=\"https://pytorch.org/\">\n <img src=\"https://img.shields.io/badge/pytorch-CB2C31?style=flat&logo=pytorch&logoColor=white\" alt=\"pytorch badge\"/>\n </a>\n <img alt=\"Dynamic JSON Badge\" src=\"https://img.shields.io/pypi/pyversions/torch\">\n <a href=\"https://badge.fury.io/py/torchcnnbuilder\">\n <img src=\"https://badge.fury.io/py/torchcnnbuilder.svg\" alt=\"PyPI version\" height=\"18\">\n </a>\n</div>\n\n---\n**TorchCNNBuilder** is an open-source framework for the automatic creation of CNN architectures. This framework should first of all help researchers in the applicability of CNN models for a huge range of tasks, taking over most of the writing of the architecture code. This framework is distributed under the 3-Clause BSD license. All the functionality is written only using `pytorch` *(no third-party dependencies)*\n\n### Installation\n\n---\nThe simplest way to install framework is using `pip`:\n```\npip install torchcnnbuilder\n```\n\n### Usage examples\n\n---\nThe basic structure of the framework is presented below. Each subdirectory has its own example of using the appropriate available functionality. You can check [`<directory>_examples.ipynb`](./examples) files in order to see the ways to use the proposed toolkit. In short, there is the following functionality:\n\n- the ability to calculate the size of tensors after (transposed) convolutional layers\n- preprocessing an n-dimensional time series in `TensorDataset`\n- automatic creation of (transposed) convolutional sequences\n- automatic creation of (transposed) convolutional layers and (transposed) blocks from convolutional layers\n\nThe structure of the main part of the package:\n\n```\n\u251c\u2500\u2500 examples\n\u2502 \u251c\u2500\u2500 builder_examples.ipynb\n\u2502 \u251c\u2500\u2500 preprocess_examples.ipynb\n\u2502 \u251c\u2500\u2500 models_examples.ipynb\n\u2502 \u2514\u2500\u2500 tools # additional functions for the examples\n\u2514\u2500\u2500 torchcnnbuilder\n \u251c\u2500\u2500 preprocess\n \u2502 \u2514\u2500\u2500 time_series.py\n \u251c\u2500\u2500 builder.py\n \u2514\u2500\u2500 models.py\n```\nInitially, the library was created to help predict n-dimensional time series *(geodata)*, so there is a corresponding functionality and templates of predictive models *(like `ForecasterBase`)*\n\n### Sources\n\n---\n- [Forecasting of Sea Ice Concentration using CNN, PDE discovery and Bayesian Networks](https://www.sciencedirect.com/science/article/pii/S1877050923020094)\n- [Surrogate Modelling for Sea Ice Concentration using Lightweight Neural Ensemble](https://arxiv.org/abs/2312.04330)\n\n",
"bugtrack_url": null,
"license": "",
"summary": "Framework for the automatic creation of CNN architectures",
"version": "0.0.19",
"project_urls": {
"Homepage": "https://github.com/ITMO-NSS-team/TorchCNNBuilder"
},
"split_keywords": [
"python",
"torch",
"cnn"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cee0adc2d18cbade3ab39a46ac00bbeeec509eea15e674b574ffa58496f0ce7b",
"md5": "43a3ba8a69417653bf5e153261fbf558",
"sha256": "50607b2cc34ca0ddbcb7782e8b631cd13e980b718e705b4969a542ce880f9f88"
},
"downloads": -1,
"filename": "torchcnnbuilder-0.0.19-py3-none-any.whl",
"has_sig": false,
"md5_digest": "43a3ba8a69417653bf5e153261fbf558",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 12115,
"upload_time": "2024-02-20T15:35:22",
"upload_time_iso_8601": "2024-02-20T15:35:22.699029Z",
"url": "https://files.pythonhosted.org/packages/ce/e0/adc2d18cbade3ab39a46ac00bbeeec509eea15e674b574ffa58496f0ce7b/torchcnnbuilder-0.0.19-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "180c82364cae0e1b8b4b06a1b5750f95139c252835d5da288dabcc8a2409069a",
"md5": "4c916ca7661a4090cd001a76ae778bc0",
"sha256": "c6ff723b590fbdf206f8964c52fec7f85004d2a54a071049802374184731ce43"
},
"downloads": -1,
"filename": "torchcnnbuilder-0.0.19.tar.gz",
"has_sig": false,
"md5_digest": "4c916ca7661a4090cd001a76ae778bc0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 12314,
"upload_time": "2024-02-20T15:35:24",
"upload_time_iso_8601": "2024-02-20T15:35:24.520141Z",
"url": "https://files.pythonhosted.org/packages/18/0c/82364cae0e1b8b4b06a1b5750f95139c252835d5da288dabcc8a2409069a/torchcnnbuilder-0.0.19.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-20 15:35:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ITMO-NSS-team",
"github_project": "TorchCNNBuilder",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "torchcnnbuilder"
}