Skip to main content

Python package to access ZTF data

Project description



This package is made to ease access to Zwicky Transient Facility data and data-products. It is maintained by M. Rigault (CNRS/IN2P3) and S. Reusch (DESY).

cite ztfquery

ztfquery: a python tool to access ztf (and SEDM) data

ztfquery contains a list of tools:



Mickael Rigault. (2018, August 14). ztfquery, a python tool to access ZTF data (Version doi). Zenodo.


If you have used ztfquery for a research you are publishing, please include the following in your acknowledgments: "The ztfquery code was funded by the European Research Council (ERC) under the European Union's Horizon 2020 research and innovation programme (grant agreement n°759194 - USNAC, PI: Rigault)."

Corresponding Authors:


ztfquery requires python >= 3.8

Install the code

using pip: pip install ztfquery (favored)

or for the latest version:

go wherever you want to save the folder and then

git clone
cd ztfquery
poetry install

Set your environment

You should also create the global variable $ZTFDATA (usually in your ~/.bash_profile or ~/.cshrc). Data you will download from IRSA will be saved in the directory indicated by $ZTFDATA following the IRSA data structure.

Login and Password storage

Your credentials will requested the first time you need to access a service (IRSA, Marshal, etc.). They will then be stored, crypted, under ~/.ztfquery. Use to reset it.

You can also directly provide account settings when running load_metadata and download_data using the auth=[your_username, your_password] parameter. Similarly, directly provide the username and password to the ztf ops page when loading NightSummary using the ztfops_auth parameter.

Quick Examples

Project details

Release history Release notifications | RSS feed

Download files

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

Source Distribution

ztfquery-1.26.1.tar.gz (248.9 kB view hashes)

Uploaded source

Built Distribution

ztfquery-1.26.1-py3-none-any.whl (256.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page