ObjObsSAP < IVOA

IVOA Web>IvoaTCG>TCG-TC-20240927>ObjObsSAP (2025-06-26, GregoryMantelet) (raw view)
---+ Object Observability Simple Access Protocol

_*Note:* This protocol is formerly known as Object Visibility Simple Access Protocol (ObjVisSAP)._

*Current status:* [[https://www.ivoa.net/documents/ObjVisSAP/20200514/index.html][WD-1.0]]

*GitHub repository:* [[https://github.com/ivoa-std/ObjObsSAP][<span data-mce-mark="1">https://github.com/ivoa-std/ObjObsSAP</span>]]

---++ Abstract

The Object Observability Simple Access Protocol (ObjObsSAP) is an IVOA Data Access protocol which defines the standard for retrieving object constraint-free observability time intervals through a uniform interface within the VO framework for given object coordinates to be observed by a given Astronomical Observatory. The ObjObsSAP services can be registered in an IVOA Registry of Resources using the VOResource, Extension standard, having a unique ResourceIdentifier in the registry. The ObjObsSAP interface is meant to be reasonably simple to be implemented by service providers. A basic query will be done introducing a set of sky coordinates and a given time period (optional). The service returns a list of constraint-free observability time intervals formatted as VOTable. Thus, an implementation of the service may support additional search parameters (some of which may be custom to that particular service) to more finely control the selection of the observability periods. The specification also describes how the search on extra parameters has to be done.

---++ Implementations

_This list of implementations is mostly inspired from the ESA page [[https://www.cosmos.esa.int/web/vovisobs_protocols][vovisobs_protocols]]._

<i><b>Legend:</b> %GREEN%<b>&#x1F592;</b>%ENDCOLOR% = up-to-date with the last version of WD-1.0</i>
---+++ Services

   * %GREEN% *&#x1F592;* %ENDCOLOR% STScI /MAST implementation based on FastAPI ( [[https://github.com/jwfraustro/fastapi-objobssap][GitHub]])
      * No service deployed yet
   * <p>The [[https://www.cosmos.esa.int/web/integral][INTEGRAL]] gamma-ray Observatory: Visibility and Observation Locator</p>
      * <p>Access URL: <span>http://integral.esa.int/isocweb/tvp.html</span></p>
   * <p>The [[http://cxc.harvard.edu/][Chandra X-ray Observatory]] (CXO): Visibility and Observation Locator (under development)</p>
      * <p>Access URL: <span>http://integral.esa.int/interest//api/visibilities/chandra</span></p>
   * <p> [[https://www.cosmos.esa.int/web/xmm-newton/home][XMM-Newton]]: Visibility and Observation Locator</p>
      * <p>Access URL: <span>http://xmmvisibility.esac.esa.int/vischecker/ServVISC</span></p>
   * <p>The [[https://www.cosmos.esa.int/web/gaia][GAIA]] mission: Visibility (displaying scanning patterns)</p>
      * <p>Access URL: <span>https://gaia.esac.esa.int/gost/ObjVisSAP/gaiaobjvisap</span></p>
   * <p>The [[http://www.hxmt.org/index.php/enhome][Insight-HXMT]] (Hard X-ray Modulation Telescope) has developed a visibility interface based on these protocols. Currently only accounting for Sun and Moon. The effects of Earth and South Atlantic Anomaly (SAA) will be included in the next version</p>
      * <p>Access URL: <span>http://integral.esa.int/interest//api/visibilities/insight-xmt</span></p>
   * <p> [[http://www.not.iac.es/][Nordical Optical Telescope (NOT)]] - basic geometrical visibility service</p>
      * <p>Access URL: <span>http://integral.esa.int/interest//api/visibilities/not</span></p>
   * <p>Swift ( [[https://github.com/Swift-SOT/swift-vo][GitHub]]):</p>
      * <p>Access URL: <span>https://www.swift.psu.edu/vo/objobssap/query</span></p>
      * <p>Access URL: <span>http://integral.esa.int/interest//api/visibilities/swift</span></p>
   * <p>The [[https://www.nustar.caltech.edu/][NuSTAR mission]] provides their [[http://www.srl.caltech.edu/NuSTAR_Public/NuSTAROperationSite/Schedule.php][schedule]] in a VO-compliant format as [[http://www.srl.caltech.edu/NuSTAR_Public/NuSTAROperationSite/][csv]] files but do not provide an URL query service</p>
      * <i>Possibly inactive<br /></i>
---+++ Clients
   * Web client [[http://integral.esa.int/toby/][TOBY]]

<span data-mce-mark="1">&lt;!--<br />      * Set ALLOWTOPICRENAME = IVOA.TWikiAdminGroup <br />--&gt;</span>
Topic revision: r3 - 2025-06-26 - GregoryMantelet
IVOA
Log in or Register
IVOA.net
Wiki Home
WebChanges
WebTopicList
WebStatistics
Twiki Meta & Help
IVOA
Know
Main
Sandbox
TWiki
TWiki intro
TWiki tutorial
User registration
Notify me
Working Groups
Interest Groups
Time Domain
Committees
Stds&Procs
www.ivoa.net
Documents
Events
Members
XML Schema