Help page for COBREX Star web service

Syntax

query/[format/][arg][&arg]*

with supported format:

• xml (default)
• html
• votable (v1.3)
• csv
• json

and query:

• fid : find star by aliases
• fid+: find stars by alias patterns
• fcoo: find stars by coordinate ranges
• fflu: find stars by G magnitude ranges
• flum: find stars by luminosity ranges
• fpar: find stars by parallax ranges
• fspt: find stars by spectral type ranges
• ffil: find stars by raw data file name (NEW)

• dist: get star distributions (NEW)

  for dist query, available arg are:

  • BY_SPECTRAL_TYPE : to get star distribution by star spectral type
  • BY_LUMINOSITY : to get star distribution by star luminosity
  • BY_PARALLAX : to get star distribution by star parallax
  • BY_MAGNITUDE : to get star distribution by star g magnitude
  • BY_FILE_OCCURRENCE : to get star distribution by number of data files related to the star
  • BY_PROCESS_OCCURRENCE: to get star distribution by number of processes run related to the star

  for dist query, the wp extra parameter can be set to:

  • wp=public : to get star distribution related to the public workspace
  • wp=all : to get star distribution related to all workspaces see examples below

Examples

Get stars by aliases

• get Beta Pic star in html format:

fid/html/bet pic

• get Beta Pic and Barnard's star stars in csv format:

fid/csv/bet%20pic&Barnard's%20star

Get stars by alias patterns

• get all Pic stars in html format:

fid+/html/pic

• get all bet stars in xml format:

fid+/xml/bet

Get stars by coordinates

• get Algorab star by coordinates in votable format:

fcoo/html/d%20187.4661%20-16.5154

Get stars by spectral types

• get O9 +- 1 stars by spectral type range in html format:

fspt/html/O9+-1

• get stars with PECULIAR spectral type range in votable format:

fspt/votable/PEC

Get stars by raw data file name

• get the star related to SPHER.2016-01-01T00:18:54.364.fits raw data file name in html format:

ffil/html/SPHER.2016-01-01T00:18:54.364.fits

• get the stars related to SPHER.2016-01-01T0* raw data file name in csv format:

ffil/csv/SPHER.2016-01-01T0

Get star distributions

• get the star distribution by spectral type in xml format:

dist/xml/BY_SPECTRAL_TYPE

• get the star distributions by spectral type and by luminosity in json format:

dist/json/BY_SPECTRAL_TYPE&BY_LUMINOSITY

• get the star distribution by G magnitude in csv format for public and all workspaces:

dist/csv/BY_MAGNITUDE?wp=public&wp=all

• get the star distribution by process occurrence in html format for only public workspace:

dist/html/BY_PROCESS_OCCURRENCE?wp=public

Python

The python API dedicated to cobrex Star web service is available here: CobrexStar.py

Also available related unit tests: CobrexStarTest.py