Metadata-Version: 2.4
Name: gtbook
Version: 0.0.41
Summary: Frank Dellaerts book support lib, made with nbdev
Home-page: https://github.com/gtbook/gtbook/tree/master/
Author: Frank Dellaert
Author-email: dellaert@gmail.com
License: Apache Software License 2.0
Keywords: python,nbdev
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: License :: OSI Approved :: Apache Software License
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: gtsam>=4.3a2
Requires-Dist: numpy>=2
Requires-Dist: requests
Requires-Dist: plotly<6,>=5.24.1
Requires-Dist: kaleido<1,>=0.2.1
Provides-Extra: dev
Requires-Dist: nbdev<3,>=2; extra == "dev"
Requires-Dist: execnb<0.2; extra == "dev"
Requires-Dist: fastcore<2; extra == "dev"
Requires-Dist: ghapi<2; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# gtbook


<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->

The book can be found at <https://www.roboticsbook.org> and has the
following chapters:

- [Introduction](https://www.roboticsbook.org/intro.html)
- [A Trash Sorting
  Robot](https://www.roboticsbook.org/S20_sorter_intro.html)
  (`discrete`)
- [A Robot Vacuum
  Cleaner](https://www.roboticsbook.org/S30_vacuum_intro.html)
  (`vacuum`)
- [Warehouse Robots in
  2D](https://www.roboticsbook.org/S40_logistics_intro.html)
  (`logistics`)
- [A Mobile Robot with Simple
  Kinematics](https://www.roboticsbook.org/S50_diffdrive_intro.html)
  (`diffdrive`)
- [Autonomous
  Vehicles](https://www.roboticsbook.org/S60_driving_intro.html)
  (`driving`)
- [Autonomous Drones in
  3D](https://www.roboticsbook.org/S70_drone_intro.html) (`drone`)

The structure of gtbook mirrors this organization, and then has a few
more support modules for displaying graphs inside notebooks and for
running the code in the book. The gtbook modules are listed above
alongside the chapter.

## How to use

In the book chapters, we should have a cell that fetches the latest
version using pip:

``` bash
%pip install -q -U gtbook
```

The above automatically installs other libraries on colab, e.g., gtsam
and plotly.

You also needs a cell that imports what you need in a particular
section, for example:

``` python
from gtbook.display import show
from gtbook.discrete import Variables
```

Further usage examples of these and more functions are given in the
module documentation itself.

There are also some command line tools defined in the `cli` module.

## Notes for development

> Mostly for Frank as he adds to the library.

- Use the root `environment.yml` for development and CI:
  `conda env create -f environment.yml`, then `conda activate nbdev2`.
- Run `pip install -e '.[dev]'` to install gtbook and the nbdev tools.
  Package and development dependencies are maintained in `settings.ini`.
  CI uses the same setup.
- to preview the docs do `nbdev_preview`
- to push a new version, use `nbdev_prepare` and then push.

If VS code gives trouble:

``` bash
export CONDA_PREFIX=/Users/dellaert/miniforge3/envs/nbdev2
conda activate nbdev2
```

To release a new version:

- `nbdev_bump_version`
- `nbdev_pypi`
