Planetary web services @ FUB Site Help

This document is intended to help you discover the web interface features on the Planetary web services @ FUB. Note that the site also offers VO-enabled services. See, for example Getting Started on GAVO's web page for more information on how to use them.

Though most of the services should work even in text-based browsers, we recommend a web browser with CSS and Javascript enabled to access the web-based services.

Service discovery

The index page lists published services available through web browsers. A "[P]" in the service listing means that the service is password protected, either because it is too rough for public consumption or because the data providers want exclusive access. In either case, you can contact the site operators to inquire about access.

In addition to web-based services, the data center also provides services accessible through IVOA standard protocols like SIAP (for images), SCS (allowing simple queries against catalogs of astronomical objects), SSAP (for spectra), and TAP (allowing complex queries against database tables of all sorts). These can be located through Virtual Observatory registry interface (e.g., WIRR) or common VO tools.

Search forms

Query Fields

Services not using customised interfaces have standard query forms. These consist of a series of input fields that either take

Query Modifiers

In most forms, you will have a "Table" query field near the bottom of the form. You can set sorting and limit options there. Note that depending on the query, selecting a column to sort on may slow down the answer dramatically. This is because your query may match large amounts of data, and even if only 100 items are returned, potentially millions of them may have to be sorted.

On the other hand, results overflowing the match limit are not reproducible without a sort option, i.e., you may get a different set of, say, 100 items for identical query parameters at two different times. The services warn you about this fact when they return truncated results.

You can usually select an output format. Options here include

Next to the output format selection, there are two links. The one labeled "[Result link]" reflects your current query as a copyable URL. You could use this to send a query result to colleagues, but it is particularly useful with the VOTable output format -- you can drag and drop that link into TOPCAT's "Open" dialogue, for example.

The star () lets you bookmark the current form -- it is basically like the result link but doesn't actually perform the query. This should come in handy to store and communicate preset queries. Note that for split-up fields (e.g., date inputs with year, month and day) you need to enter all pieces of information for this to work.

Both the result and the bookmark links require Javascript to work.

The sidebar

The sidebar on form and result pages contains ancillary information for the resource the data comes from. To save space, the individual items are "folded in" by default. Mouse over them to see the full entries.

The "Created" metadata item shown refers to the creation of the resource descriptor, i.e., is related to the service rather than the data. The "Data updated" item gives the date of the last "import" of a piece of the data. Unless a service supports online modification, it can be used as an indicator of the version of the underlying data.

Timeouts

With ADQL, it is not hard to construct queries that will run for days or weeks, and even normal web-based queries can select so much data that excessive runtimes and possibly huge data volumes result. Ususally, this is not intended by the users, and thus by default relatively short timeouts are imposed on the run time of the queries on the server (of the order 10 seconds).

You can usually increase the timeout by generating a link to your query (see "Result link" above) and appending "&_TIMEOUT=100 (or whatever number of seconds suits you) to the URL. The ADQL form has an input field that does just this.

However, usually long-running queries indicate that we should be adding some index to our tables. Thus, please contact us with your queries and we will try to speed them up.

Login and logout

In the sidebar, you will usually see a login item. You should normally not need to be concerned with this, since protected services will query your credentials as needed. You may want to log out, though; if you click on the "log out <user>" link, a login mask will pop up. Leave the username blank and click OK to log out. If you click Cancel (or equivalent), you will remain logged in. This slight weirdness is inevitable when using HTTP authentication with current browsers.

There is one situation in which you will want to log in: Access to protected products from open services. You will note that in such cases, the system will deny access to the protected products without asking your credentials. If you can provide those, log in and try again.

To obtain usernames and passwords, contact s.walter@fu-berlin.de.

Software availability

The software driving this site is available for download and inspection. For details see the DaCHS installation guide. All our code is released under the GPL.

Acknowledgements

This software uses services provided by the Centre de Données astronomiques de Strasbourg, France.

Some of the services were created using software from astrometry.net.

Some of the services use q3c indexing by Sergey Koposov and Oleg Bartunov, see 2006ASPC..351..735K.

Privacy

See our privacy policy.