Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

TOM Toolkit

pypi run-tests Codacy Badge Coverage Status Documentation Status ASCL

Documentation logo

The TOM Toolkit is a web framework for building TOMs: Target and Observation Managers. TOMs are meant to facilitate collaborative astronomical observing projects. A typical TOM allows its users to curate target lists, request observations of those targets at various observatories as well as manage and organize their data. Read more about TOMs.

Getting started with the TOM Toolkit

The getting started guide will guide you through the process of setting up a TOM for the first time.

Reporting issues/feature requests

Please use the issue tracker to report any issues or support questions.

Development Team

The lead developers of the TOM Toolkit are William Lindstrom and Joey Chatelain, professional software developers with the Las Cumbres Observatory software team, together with Jon Nation, Curtis McCully, Matt Daily and Mark Bowman. Rachel Street is the project's Principle Investigator. The TOM Toolkit is grateful for the advice and collaboration with Andy Howell, Edward Gomez, Craig Pellegrino, Jamie Burke and the rest of the LCO Science team. The original Toolkit was developed by Austin Riba, David Collom and William Lindstrom.

Our team very much welcome input from the community, and we are grateful to the following people for their many contributions:

  • Dan Avner, NOIRLab
  • Doug Arnold, Liverpool Telescope
  • Etienne Bachelet, IPAC/Caltech
  • Ezequiel Contreras Martinez, UCSB
  • Griffin Hosseinzadeh, University of Arizona
  • Bryan Miller, Gemini Observatory
  • Brendan Mills, UCSB
  • Julien Peloton, Fink

Acknowledgements

We hope you find our software useful for your research. If so, we would be grateful if you can include a brief acknowledgement in your papers and presentations, for example "This research made use of The TOM Toolkit". We would also very much appreciate you including a citation to our paper describing the Toolkit Street, R.A. et al., 2018, SPIE, 10707, 11 (to export the BibTeX please click here).

Contributing to the project

If you'd like to contribute to the TOM Toolkit, first of all, thanks! Secondly, we have a contribution guide that you might find helpful. We are particularly interested in the contribution of observation and alert modules.

Community Code of Conduct

We encourage developers to maintian a lively and civil discourse either on github or in our slack workspace. Please review our code of conduct for information about what is considered unacceptable behavior and how to report it.

Developer information

For development information targeted at the maintainers of the project, please see README-dev.md.

Plugins

Different TOM systems have different science goals and sometimes need different functions. Rather than require users to support all dependencies from all possible functions, we support a range of optional plugin modules for the Toolkit. Have a look at our list of plugins see which would benefit your science goals.

Antares

The tom-antares plugin adds support for querying the Antares broker for targets of interest.

tom_nonsidereal_airmass

The tom_nonsidereal_airmass plugin provides a templatetag that supports plotting for non-sidereal objects. The plugin is fully supported by the TOM Toolkit team; however, non-sidereal visibility calculations require the PyEphem library, which is minimally supported while its successor is in development. The library used for the TOM Toolkit sidereal visibility, astroplan, does not yet support non-sidereal visibility calculations.

tom-lt

This module provides the ability to submit observations to the Liverpool Telescope Phase 2 system. It is in a very alpha state, with little error handling and minimal instrument options, but can successfully submit well-formed observation requests.

Github

tom_registration

The tom_registration plugin introduces support for two TOM registration flows--an open registration, and a registration that requires administrator approval. Our philosophy is to keep the TOM as lightweight and adaptable as possible.

About the TOM Toolkit

The TOM Toolkit is managed by Las Cumbres Observatory, with generous financial support from the National Science Foundation grant 2209852. We are also grateful for support from the Heising-Simons Foundation and the Zegar Family Foundation at the start of the project.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tomtoolkit-3.0.0a13.tar.gz (14.5 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tomtoolkit-3.0.0a13-py3-none-any.whl (1.5 MB view details)

Uploaded Python 3

File details

Details for the file tomtoolkit-3.0.0a13.tar.gz.

File metadata

  • Download URL: tomtoolkit-3.0.0a13.tar.gz
  • Upload date:
  • Size: 14.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for tomtoolkit-3.0.0a13.tar.gz
Algorithm Hash digest
SHA256 be48bf5e38fe129fbf46d27b2eb7ce9aaa69dcecbf6c41077f80eca08c1a4c8a
MD5 34905d26147970673399f707b2d3c090
BLAKE2b-256 134f70ef512576c7e50e2348f270b5ccede93a9e29576ff3183dfaecf472f197

See more details on using hashes here.

Provenance

The following attestation bundles were made for tomtoolkit-3.0.0a13.tar.gz:

Publisher: pypi-release.yml on TOMToolkit/tom_base

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tomtoolkit-3.0.0a13-py3-none-any.whl.

File metadata

  • Download URL: tomtoolkit-3.0.0a13-py3-none-any.whl
  • Upload date:
  • Size: 1.5 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for tomtoolkit-3.0.0a13-py3-none-any.whl
Algorithm Hash digest
SHA256 0be7b5d6aca5bc2251a4aadf160f22cca2e8ff79a6e56d800a5945c52fba96a5
MD5 5e694d4e3d0768956160a5f144fe061f
BLAKE2b-256 593d93b46d16a7d656b730d2f571290f2675a129bdaa112246c9dbd275b60687

See more details on using hashes here.

Provenance

The following attestation bundles were made for tomtoolkit-3.0.0a13-py3-none-any.whl:

Publisher: pypi-release.yml on TOMToolkit/tom_base

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page