Skip to content

Archive NED

github-actions[bot] edited this page Sep 28, 2026 · 1 revision

NASA/IPAC Extragalactic Database for galaxies and extragalactic objects.

  • Module name: ned
  • Python class: astroquery.ipac.ned.Ned
  • Functions: 17

Call any function below with the astroquery_execute MCP tool. Descriptions are taken from the upstream astroquery/astropy docstrings.

Function Summary
clear_cache Removes all cache files.
get_image_list Helper function that returns a list of urls from which to download
get_images Query function to fetch FITS images for a given identifier.
get_images_async Serves the same purpose as get_images but returns
get_spectra Query function to fetch FITS files of spectra for a given identifier.
get_spectra_async Serves the same purpose as get_spectra but returns
get_table Fetches the specified data table for the object from NED and returns
get_table_async Serves the same purpose as query_region but returns the
query_object Queries objects by name from the NED Service and returns the Main
query_object_async Serves the same purpose as query_object but returns the
query_refcode Used to retrieve all objects contained in a particular
query_refcode_async Serves the same purpose as query_region but returns the
query_region Used to query a region around a known identifier or given
query_region_async Serves the same purpose as query_region but returns the
query_region_iau Used to query the Ned service via the IAU name. Equivalent to the
query_region_iau_async Serves the same purpose as query_region_iau but returns
reset_cache_location Resets the cache location to the default astropy cache

Functions

clear_cache

Removes all cache files.

Ned.clear_cache()

Call via MCP

astroquery_execute(
    module_name="ned",
    function_name="clear_cache",
    params={},
)

Parameters

No parameters.

get_image_list

Helper function that returns a list of urls from which to download

Ned.get_image_list(object_name, *, item='image', file_format='fits', get_query_payload=False)

Call via MCP

astroquery_execute(
    module_name="ned",
    function_name="get_image_list",
    params={"object_name": "<object_name>"},
)

the FITS images.

Parameters

Parameter Type Default Description
object_name (required) str name of the identifier to query.
item str 'image' Can be either 'image' or 'spectra'. Defaults to 'image'. Required to decide the right URL to query.
file_format str 'fits' Format of images/spectra to return. Defaults to 'fits'. Other options available: 'author-ascii', 'NED-ascii', 'VO-table'.
get_query_payload bool False if set to True then returns the dictionary sent as the HTTP request. Defaults to False

Returns

list of image urls —

get_images

Query function to fetch FITS images for a given identifier.

Ned.get_images(object_name, *, get_query_payload=False, show_progress=True)

Call via MCP

astroquery_execute(
    module_name="ned",
    function_name="get_images",
    params={"object_name": "<object_name>"},
)

Parameters

Parameter Type Default Description
object_name (required) str name of the identifier to query.
get_query_payload bool False if set to True then returns the dictionary sent as the HTTP request. Defaults to False
show_progress True

Returns

A list of HDUList objects —

get_images_async

Serves the same purpose as get_images but returns

Ned.get_images_async(object_name, *, get_query_payload=False, show_progress=True)

Call via MCP

astroquery_execute(
    module_name="ned",
    function_name="get_images_async",
    params={"object_name": "<object_name>"},
)

file-handlers to the remote files rather than downloading them.

Parameters

Parameter Type Default Description
object_name (required) str name of the identifier to query.
get_query_payload bool False if set to True then returns the dictionary sent as the HTTP request. Defaults to False
show_progress True

Returns

A list of context-managers that yield readable file-like objects —

get_spectra

Query function to fetch FITS files of spectra for a given identifier.

Ned.get_spectra(object_name, *, get_query_payload=False, show_progress=True)

Call via MCP

astroquery_execute(
    module_name="ned",
    function_name="get_spectra",
    params={"object_name": "<object_name>"},
)

Parameters

Parameter Type Default Description
object_name (required) str name of the identifier to query.
get_query_payload bool False if set to True then returns the dictionary sent as the HTTP request. Defaults to False
show_progress True

Returns

A list of HDUList objects —

get_spectra_async

Serves the same purpose as get_spectra but returns

Ned.get_spectra_async(object_name, *, get_query_payload=False, show_progress=True)

Call via MCP

astroquery_execute(
    module_name="ned",
    function_name="get_spectra_async",
    params={"object_name": "<object_name>"},
)

file-handlers to the remote fits files rather than downloading them.

Parameters

Parameter Type Default Description
object_name (required) str name of the identifier to query.
get_query_payload bool False if set to True then returns the dictionary sent as the HTTP request. Defaults to False
show_progress True

Returns

A list of context-managers that yield readable file-like objects —

get_table

Fetches the specified data table for the object from NED and returns

Ned.get_table(object_name, *, table='photometry', get_query_payload=False, verbose=False, **kwargs)

Call via MCP

astroquery_execute(
    module_name="ned",
    function_name="get_table",
    params={"object_name": "<object_name>"},
)

it as an astropy.table.Table.

Parameters

Parameter Type Default Description
object_name (required) str name of the identifier to query.
table str 'photometry' Must be one of ['photometry'|'positions'|'diameters'|'redshifts'|'references'|'object_notes']. Specifies the type of data-table that must be fetched for the given object. Defaults to 'photometry'.
get_query_payload bool False if set to True then returns the dictionary sent as the HTTP request. Defaults to False.
verbose bool, optional. False When set to True displays warnings if the returned VOTable does not conform to the standard. Defaults to False.
**kwargs

Returns

astropy.table.Table — The result of the query as an astropy.table.Table object.

get_table_async

Serves the same purpose as query_region but returns the

Ned.get_table_async(object_name, *, table='photometry', get_query_payload=False, **kwargs)

Call via MCP

astroquery_execute(
    module_name="ned",
    function_name="get_table_async",
    params={"object_name": "<object_name>"},
)

raw HTTP response rather than the astropy.table.Table object.

Parameters

Parameter Type Default Description
object_name (required) str name of the identifier to query.
table str 'photometry' Must be one of ['photometry'|'positions'|'diameters'|'redshifts'|'references'|'object_notes']. Specifies the type of data-table that must be fetched for the given object. Defaults to 'photometry'.
get_query_payload bool False if set to True then returns the dictionary sent as the HTTP request. Defaults to False.
**kwargs

Returns

requests.Response — The HTTP response returned from the service.

query_object

Queries objects by name from the NED Service and returns the Main

Ned.query_object(object_name, *, get_query_payload=False, verbose=False)

Call via MCP

astroquery_execute(
    module_name="ned",
    function_name="query_object",
    params={"object_name": "<object_name>"},
)

Source Table.

Parameters

Parameter Type Default Description
object_name (required) str name of the identifier to query.
get_query_payload bool False if set to True then returns the dictionary sent as the HTTP request. Defaults to False.
verbose bool, optional. False When set to True displays warnings if the returned VOTable does not conform to the standard. Defaults to False.

Returns

astropy.table.Table — The result of the query as an astropy.table.Table object.

query_object_async

Serves the same purpose as query_object but returns the

Ned.query_object_async(object_name, *, get_query_payload=False)

Call via MCP

astroquery_execute(
    module_name="ned",
    function_name="query_object_async",
    params={"object_name": "<object_name>"},
)

raw HTTP response rather than the astropy.table.Table object.

Parameters

Parameter Type Default Description
object_name (required) str name of the identifier to query.
get_query_payload bool False if set to True then returns the dictionary sent as the HTTP request. Defaults to False

Returns

requests.Response — The HTTP response returned from the service

query_refcode

Used to retrieve all objects contained in a particular

Ned.query_refcode(refcode, *, get_query_payload=False, verbose=False)

Call via MCP

astroquery_execute(
    module_name="ned",
    function_name="query_refcode",
    params={"refcode": "<refcode>"},
)

reference. Equivalent to by refcode queries of the web interface.

Parameters

Parameter Type Default Description
refcode (required) str 19 digit reference code. Example: 1997A&A...323...31K.
get_query_payload bool False if set to True then returns the dictionary sent as the HTTP request. Defaults to False.
verbose bool, optional. False When set to True displays warnings if the returned VOTable does not conform to the standard. Defaults to False.

Returns

astropy.table.Table — The result of the query as an astropy.table.Table object.

query_refcode_async

Serves the same purpose as query_region but returns the

Ned.query_refcode_async(refcode, *, get_query_payload=False)

Call via MCP

astroquery_execute(
    module_name="ned",
    function_name="query_refcode_async",
    params={"refcode": "<refcode>"},
)

raw HTTP response rather than the astropy.table.Table object.

Parameters

Parameter Type Default Description
refcode (required) str 19 digit reference code. Example: 1997A&A...323...31K.
get_query_payload bool False if set to True then returns the dictionary sent as the HTTP request. Defaults to False.

Returns

requests.Response — The HTTP response returned from the service.

query_region

Used to query a region around a known identifier or given

Ned.query_region(coordinates, *, radius=<Quantity 1. arcmin>, equinox='J2000.0', get_query_payload=False, verbose=False)

Call via MCP

astroquery_execute(
    module_name="ned",
    function_name="query_region",
    params={"coordinates": "<coordinates>"},
)

coordinates. Equivalent to the near position and near name queries from the Ned web interface.

Parameters

Parameter Type Default Description
coordinates (required) str or astropy.coordinates object The target around which to search. It may be specified as a string in which case it is resolved using online services or as the appropriate astropy.coordinates object. ICRS coordinates may also be entered as strings as specified in the astropy.coordinates module.
radius str or Quantity object <Quantity 1. arcmin> The string must be parsable by Angle. The appropriate Quantity object from astropy.units may also be used. Defaults to 1 arcmin.
equinox str 'J2000.0' The equinox may be either J2000.0 or B1950.0. Defaults to J2000.0
get_query_payload bool False if set to True then returns the dictionary sent as the HTTP request. Defaults to False.
verbose bool, optional. False When set to True displays warnings if the returned VOTable does not conform to the standard. Defaults to False.

Returns

astropy.table.Table — The result of the query as an astropy.table.Table object.

query_region_async

Serves the same purpose as query_region but returns the

Ned.query_region_async(coordinates, *, radius=<Quantity 1. arcmin>, equinox='J2000.0', get_query_payload=False)

Call via MCP

astroquery_execute(
    module_name="ned",
    function_name="query_region_async",
    params={"coordinates": "<coordinates>"},
)

raw HTTP response rather than the astropy.table.Table object.

Parameters

Parameter Type Default Description
coordinates (required) str or astropy.coordinates object The target around which to search. It may be specified as a string in which case it is resolved using online services or as the appropriate astropy.coordinates object. ICRS coordinates may also be entered as strings as specified in the astropy.coordinates module.
radius str or Quantity object <Quantity 1. arcmin> The string must be parsable by astropy.coordinates.Angle. The appropriate Quantity object from astropy.units may also be used. Defaults to 1 arcmin.
equinox str 'J2000.0' The equinox may be either J2000.0 or B1950.0. Defaults to J2000.0
get_query_payload bool False if set to True then returns the dictionary sent as the HTTP request. Defaults to False.

Returns

requests.Response — The HTTP response returned from the service

query_region_iau

Used to query the Ned service via the IAU name. Equivalent to the

Ned.query_region_iau(iau_name, *, frame='Equatorial', equinox='B1950.0', get_query_payload=False, verbose=False)

Call via MCP

astroquery_execute(
    module_name="ned",
    function_name="query_region_iau",
    params={"iau_name": "<iau_name>"},
)

IAU format queries of the Web interface.

Parameters

Parameter Type Default Description
iau_name (required) str IAU coordinate-based name of target on which search is centered. Definition of IAU coordinates at https://cds.unistra.fr/Dic/iau-spec.html.
frame str 'Equatorial' May be one of 'Equatorial', 'Ecliptic', 'Galactic', 'SuperGalactic'. Defaults to 'Equatorial'.
equinox str 'B1950.0' The equinox may be one of J2000.0 or B1950.0. Defaults to B1950.0
get_query_payload bool False if set to True then returns the dictionary sent as the HTTP request. Defaults to False
verbose bool, optional. False When set to True displays warnings if the returned VOTable does not conform to the standard. Defaults to False.

Returns

astropy.table.Table — The result of the query as an astropy.table.Table object.

query_region_iau_async

Serves the same purpose as query_region_iau but returns

Ned.query_region_iau_async(iau_name, *, frame='Equatorial', equinox='B1950.0', get_query_payload=False)

Call via MCP

astroquery_execute(
    module_name="ned",
    function_name="query_region_iau_async",
    params={"iau_name": "<iau_name>"},
)

the raw HTTP response rather than the astropy.table.Table object.

Parameters

Parameter Type Default Description
iau_name (required) str IAU coordinate-based name of target on which search is centered. Definition of IAU coordinates at https://cds.unistra.fr/Dic/iau-spec.html.
frame str 'Equatorial' May be one of 'Equatorial', 'Ecliptic', 'Galactic', 'SuperGalactic'. Defaults to 'Equatorial'.
equinox str 'B1950.0' The equinox may be one of J2000.0 or B1950.0. Defaults to B1950.0
get_query_payload bool False if set to True then returns the dictionary sent as the HTTP request. Defaults to False

Returns

requests.Response — The HTTP response returned from the service.

reset_cache_location

Resets the cache location to the default astropy cache

Ned.reset_cache_location()

Call via MCP

astroquery_execute(
    module_name="ned",
    function_name="reset_cache_location",
    params={},
)

Parameters

No parameters.

Clone this wiki locally