Currently the primary access to the PanSTARRS catalog is through database queries using the MAST CasJobs interface, and the primary access to the PS1 images is through the PS1 Image Cutout Service. There is also a simple web form to search the catalog for objects near a sky position and a VO-compatible cone search interface for simple positional searches. A VO TAP service also provides direct SQL query access to the database. Both catalog and image interfaces can be used from scripts. The DR2 search API is fully functional and can be used to search various tables with constraints from any of the table columns.  The PS1 images are also accessible via the MAST Portal.  Python notebooks are provided with examples of access via various interfaces.

The starting point for the PS1 data archive is at Pan-STARRS1 data archive home page.


Contents

Catalog Access Tools

The PanSTARRS catalog is a large database of the objects and measurements of their properties including astrometry, photometry, and morphology. It includes copious metadata including links to the images that were used for the various object measurements. The total database size for the DR2 release is nearly 150 TB.

Search Forms

A simple web form searches the object catalog for objects near a search position.

    • https://catalogs.mast.stsci.edu/
    • The form includes a name resolver allowing positions to be specified using object names recognized by SIMBAD or NED.
    • The form can search multiple tables from the catalog, including mean objects, stack objects, and detections.  Additional tables will be added in the near future.
    • A list of target names or positions can be uploaded to search multiple positions at once.  (Currently this is relatively slow, but enhancements coming soon will make it much faster.)
    • The user can customize the columns returned from the search and can add additional constraints on the search (e.g., using magnitudes or other columns from the catalogs). 
      • We recommend using the nDetections>=2 constraint when searching the mean objects catalog to reduce the number of spurious objects in the catalog.  Such object are usually detected at only a single epoch.
    • The search results from this form can be view interactively or downloaded as a comma-separated value file.
    • The form has an associated application program interface (API) that can be used for programmatic (scripted) queries to the catalog.  The API includes access to all the functionality of the interface, including constraints, selection of columns, etc.  It can return the data in various formats including CSV, JSON, VOTables.  It also has a metadata query to get a list of the available columns for a particular table.
    • Note: The old web form at http://archive.stsci.edu/panstarrs/search.php remains available but can only be used to search the DR1 catalog.  It also lacks many of the filtering capabilities of the new interface.  We recommend that all users of the old interface switch to the new interface.  Eventually the old interface will be retired.

Easy cross-match using catalogs API

VO Cone search

SQL query interface: MAST CasJobs

SQL query interface: VO TAP

  • The VO Table Access Protocol (TAP) interface allows database queries through a SQL-based language.  The MAST PS1 TAP interface can be used to query the PS1 database.  See the TAP documentation for details about how TAP services work.
  • A Jupyter notebook shows how to query the database from Python.
  • The PS1 TAP service is also accessible from standard VO tools such as TOPCAT.  In TOPCAT, use the VO → Table Access Protocol menu to get a list of list of services, and then search for PS1DR2 to find the TAP service.

Image Access Tools

The PS1 images are available for the five PS1 filters for combined multi-epoch stacked images. and, with DR2, to the single epoch "warp" images.

PS1 Image Cutout Service

  • The PS1 Image Cutout Service provides color images, JPEG and FITS cutouts, an interactive image display, and full FITS image retrievals.
  • The image cutout service is programmatically accessible to allow downloading either cutouts or full images via a script.  There is a simple Python Jupyter notebook that shows how to download images.

MAST Portal

  • PanSTARRS images are also accessible via the MAST Portal, which provides both a flexible interactive interface (which integrates the PS1 images with the other MAST holdings include Hubble data).
  • The Portal also has a powerful API that provides programmatic access to MAST data holdings.


Data Retrieval Quick Links
Catalog and Database Access
Search formhttps://catalogs.mast.stsci.edu
VO Cone Search

http://gsss.stsci.edu/webservices/vo/CatalogSearch.aspx?CAT=PS1dr2OBJECTS&RA=<ra>&DEC=<dec-degrees>&SR=<radius-degrees>

CasJobshttps://mastweb.stsci.edu/ps1casjobs/
VO TAPhttp://vao.stsci.edu/PS1DR2/tapservice.aspx
Image Access
Image cutout servicehttps://ps1images.stsci.edu/cgi-bin/ps1cutouts
MAST portalhttps://mast.stsci.edu
  • No labels