How to do?

SsODNet . datacloud

Sso Properties

How to use SsODNet.datacloud?

The best friendly way to get SSO properties from SsODNet.datacloud is to use the “rocks” API. This is a command-line Python software allowing to request properties with simple and natural commands. Read the documentation for more information and tutorials.

Another way to get properties is to use the SsODNet.datacloud Webservice.

How to name objects?

To query the properties of a given solar system object you must provide a name or a pattern which can be resolved by the SsODNet.resolver method. See the section "How to name objects" of the resolver method.


The datacloud service may also accept a list of target names to retrieve their data in a single request. The list of targets must be provided as a text file (unicode UTF-8 format) containing a name per line (example) or a JSON array (example). This file may be downloadable by the SsODNet server from an URL provided through the -name argument of the datacloud HTTP request, or may be submitted to the SsODNet server through a POST request (parameter = targets). In that case, the -name argument must be left empty.

Examples to retrieve the diameters and albedos of a list of targets:

curl -F "targets=@target_list.json" \
 "" \
 -o diamalbedo.json

How to get SSO properties?

Each property refers to a dataset which has been aggregated in SsODNet database. This can be an original dataset (e.g. ASTORB), or a home-made dataset built from many articles (e.g. diamalbedo). Each dataset contains the most comprehensive list of estimates and measurements of dynamical and physical properties of SSOs, and is defined by a unique collection name.

To discover the collections that make up SsODNet.datacloud, you must use the reserved keyword collection.


To know which bibliographic references have been used to populate the collections or a given collection, you must use the reserved keyword bibref.


To list the collections that contain properties for a given SSO, you must use the reserved keyword list.


To get the properties of a given SSO, you must provide the name of the collection, or use the optional reserved keyword all to get all its properties.


How to get the best estimates of properties?