Metadata-Version: 2.1
Name: bsr
Version: 0.1.1
Summary: Blender integration tools for soft-rod system.
License: MIT
Keywords: data-analysis
Requires-Python: >=3.10,<3.12
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: bpy (==4.0.0) ; python_version >= "3.10.dev0" and python_version < "3.11.dev0"
Requires-Dist: bpy (==4.1.0) ; python_version >= "3.11.dev0" and python_version < "3.12.dev0"
Requires-Dist: click (>=8.1.7,<9.0.0)
Requires-Dist: mathutils (>=3.3.0,<4.0.0)
Description-Content-Type: text/markdown

<div align="center">
<h1> Blender Soft Arm </h1>

<img src="https://img.shields.io/badge/Python-3776AB?style=flat&logo=Python&logoColor=white"/>
<a href='https://blender-soft-rod.readthedocs.io/en/latest/?badge=latest'>
    <img src='https://readthedocs.org/projects/blender-soft-rod/badge/?version=latest' alt='Documentation Status' />
</a>

</div>

----
# Blender Soft Arm

The Blender Soft Arm (bsr) includes data visualization tools and analysis for soft-arm robotics data.
The slender body is defined by a series of points and radius, and the data is visualized in [Blender](https://www.blender.org/).

## How to install

Easiest way to install the stable version of the package is to use `pip`:

```sh
pip install bsr
```

## Examples

We provide minimal [example scripts](.examples) to demonstrate the usage of the package.

## Development version

The development version includes unit-tests, documentation, examples, and other development tools.
We primarily use [`poetry`](https://python-poetry.org/) to manage the dependencies and the development environment.
Necessary commands are provided in the `Makefile`.

```sh
git clone https://github.com/GazzolaLab/Blender-Soft-Rod.git
cd Blender-Soft-Rod
make install  # Assuming you have poetry installed.
make pre-commit-install
```

Below are additional commands that you can use to manage the development environment.

- Documentation

```sh
cd docs
make clean
make html
open build/html/index.html
```

- Unittests

```sh
make test
```

- Code formatting

```sh
make formatting
```

- Check type-hinting

```sh
make mypy
```

