Skip to main content

See full documentation at https://KumarRobotics.github.io/CoverageControl/

Introduction

Coverage control is the problem of navigating a robot swarm to collaboratively monitor features or a phenomenon of interest not known a priori. The library provides a simulation environment, algorithms, and GNN-based architectures for the coverage control problem.

Key features:

  • The core library is written in C++ and CUDA to handle large-scale simulations
  • There are python bindings that interface with the core library
  • Several Centroidal Voronoi Tessellation (CVT)-based algorithms (aka Lloyd's algorithms)
  • Learnable Perception-Action-Communication (LPAC) architecture for the coverage control problem is implemented in PyTorch and PyTorch Geometric

Getting Started

The library is available as a pip package. To install the package, run the following command:

pip install coverage_control

See Installation for more details on installation.

See Quick Start guide for a quick introduction to the library.


Citation

@article{agarwal2024lpac,
      title         =   {LPAC: Learnable Perception-Action-Communication Loops with
                            Applications to Coverage Control}, 
      author        =   {Saurav Agarwal and Ramya Muthukrishnan and 
                            Walker Gosrich and Vijay Kumar and Alejandro Ribeiro},
      year          =   {2024},
      eprint        =   {2401.04855},
      archivePrefix =   {arXiv},
      primaryClass  =   {cs.RO}
}

LPAC: Learnable Perception-Action-Communication Loops with Applications to Coverage Control.
Saurav Agarwal, Ramya Muthukrishnan, Walker Gosrich, Vijay Kumar, and Alejandro Ribeiro.
arXiv preprint arXiv:2401.04855 (2024).

Acknowledgements

Support and Funding

The work was performed at the GRASP Laboratory and the Alelab, University of Pennsylvania, USA.

This work was supported in part by grants ARL DCIST CRA W911NF-17-2-0181 and ONR N00014-20-1-2822.

Contributors

License

The library is licensed under the GPL-3.0 License. The documentation is not under the GPL-3.0 License and is licensed under the CC BY-NC-SA 4.0 License.

Release files for coverage-control 1.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for coverage-control 1.3.1
File Size Uploaded
coverage_control-1.3.1.tar.gz 10.2 MB Details

Built distributions (wheels)

Table of built distributions (wheels) for coverage-control 1.3.1
File
coverage_control-1.3.1-cp313-cp313-manylinux_2_28_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.28+ x86-64 Details
coverage_control-1.3.1-cp312-cp312-manylinux_2_28_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.28+ x86-64 Details
coverage_control-1.3.1-cp311-cp311-manylinux_2_28_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.28+ x86-64 Details
coverage_control-1.3.1-cp310-cp310-manylinux_2_28_x86_64.whl CPython 3.10 CPython 3.10 Linux glibc 2.28+ x86-64 Details

Total release size: 19.8 MB

Release files / coverage_control-1.3.1.tar.gz

Download URL coverage_control-1.3.1.tar.gz
Size 10.2 MB
Tags Source
SHA-256 checksum
How to use checksums
47c93d79a4de5f00e893bdceb8d1b19d1d71ad265228caf7af6c2f8ba29798f2
BLAKE2b-256 checksum
How to use checksums
e7786369d641f13cd69afe634f09c4f4350cffb8f49bb94bebe7bfbb6b80b7fb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.1.1 CPython/3.12.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2024.

Transparency log

Release files / coverage_control-1.3.1-cp313-cp313-manylinux_2_28_x86_64.whl

Download URL coverage_control-1.3.1-cp313-cp313-manylinux_2_28_x86_64.whl
Size 2.4 MB
Tags CPython 3.13 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
e11e0eb8fa90f0a6c257a8613efa1f209d95450a1d271d6b6db6bb3148150979
BLAKE2b-256 checksum
How to use checksums
d20b8391bcbb311c74aefb0b7592c3e81e161ce6e2b2755dc5e9abe9049dbeb3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.1.1 CPython/3.12.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2024.

Transparency log

Release files / coverage_control-1.3.1-cp312-cp312-manylinux_2_28_x86_64.whl

Download URL coverage_control-1.3.1-cp312-cp312-manylinux_2_28_x86_64.whl
Size 2.4 MB
Tags CPython 3.12 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
8d8baf43f3f1c83013a86cf662279005658cdff676ef2e0bf5f1fc92e6c79c26
BLAKE2b-256 checksum
How to use checksums
a776a2023fdcde271924393a6371fdfcfb854c015f4ba7e77a6d2d06b843c59b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.1.1 CPython/3.12.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2024.

Transparency log

Release files / coverage_control-1.3.1-cp311-cp311-manylinux_2_28_x86_64.whl

Download URL coverage_control-1.3.1-cp311-cp311-manylinux_2_28_x86_64.whl
Size 2.4 MB
Tags CPython 3.11 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
9d776bf3aa3c323142066bae4c2fba0197fd0c21693635c7fd5f2212571b6b68
BLAKE2b-256 checksum
How to use checksums
e2fb9dfb99cd71713fe7d86a7aa97de82de3149d51d717eb4300a06b9f5e8b95
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.1.1 CPython/3.12.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2024.

Transparency log

Release files / coverage_control-1.3.1-cp310-cp310-manylinux_2_28_x86_64.whl

Download URL coverage_control-1.3.1-cp310-cp310-manylinux_2_28_x86_64.whl
Size 2.4 MB
Tags CPython 3.10 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
64ac088e571ca320ee714acf03b0bd76744b17235254134158af3f62e7d43651
BLAKE2b-256 checksum
How to use checksums
c159911558268153adee5e6cbc29c4fb58dfb87dfb51103e9289f058e7e6d964
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.1.1 CPython/3.12.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2024.

Transparency log

Release history Release notifications | RSS feed

This release

1.3.1 This release

5 release files

1.2.0

4 release files

1.1.0

4 release files

1.0.0

4 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page