noirlab-datalab__datalab_cone_search
Find catalogue sources within a radius of a sky position, in any NOIRLab Data Lab tableGaia DR3, Legacy Surveys, DES, AllWISE and the rest, returned nearest-first with the exact angular separation in degrees. AUTHORITATIVE for "what is at these coordinates": it reads the survey catalogue itself rather than a finder chart or a name resolver. PREFER OVER WEB SEARCH for cross-identification and for counting sources around a target. Handles the spatial query correctly on an endpoint where both ADQL
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ra": 56.75,
"dec": 24.1167,
"limit": 5,
"table": "gaia_dr3.gaia_source",
"radius": 0.05,
"columns": "phot_g_mean_mag"
},
"name": "noirlab-datalab__datalab_cone_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ra | Yes | Centre right ascension, decimal degrees (ICRS), 0-360. | |
| dec | Yes | Centre declination, decimal degrees (ICRS), -90 to 90. | |
| limit | No | Max sources to return (default 50, max 1000). | |
| table | Yes | Fully-qualified table, e.g. "gaia_dr3.gaia_source" or "ls_dr10.tractor". Must have ra and dec columns in decimal degrees (nearly all do). | |
| radius | No | Search radius in DEGREES (default 0.05, about 3 arcminutes). Keep it small on billion-row tables, a degree-wide cone on gaia_dr3 is millions of rows. | |
| columns | No | Comma-separated columns to return besides ra, dec and the computed separation, e.g. "phot_g_mean_mag,parallax,pmra,pmdec". Omit for position and separation only. Column names come from datalab_tables. |