NED

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`

Call via MCP

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

NedClass.clear_cache(): Removes all cache files.

`get_image_list`

Call via MCP

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

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

Helper function that returns a list of urls from which to download the FITS images.

Parameters:

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

Return type:

list of image urls

`get_images`

Call via MCP

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

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

Query function to fetch FITS images for a given identifier.

Parameters:

object_name (str) – name of the identifier to query.
get_query_payload (bool, optional) – if set to True then returns the dictionary sent as the HTTP request. Defaults to False

Return type:

A list of HDUList objects

`get_images_async`

Call via MCP

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

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

Serves the same purpose as get_images but returns file-handlers to the remote files rather than downloading them.

Parameters:

object_name (str) – name of the identifier to query.
get_query_payload (bool, optional) – if set to True then returns the dictionary sent as the HTTP request. Defaults to False

Return type:

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

`get_spectra`

Call via MCP

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

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

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

Parameters:

object_name (str) – name of the identifier to query.
get_query_payload (bool, optional) – if set to True then returns the dictionary sent as the HTTP request. Defaults to False

Return type:

A list of HDUList objects

`get_spectra_async`

Call via MCP

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

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

Serves the same purpose as get_spectra but returns file-handlers to the remote fits files rather than downloading them.

Parameters:

object_name (str) – name of the identifier to query.
get_query_payload (bool, optional) – if set to True then returns the dictionary sent as the HTTP request. Defaults to False

Return type:

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

`get_table`

Call via MCP

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

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

Fetches the specified data table for the object from NED and returns it as an astropy.table.Table.

Parameters:

object_name (str) – name of the identifier to query.
table (str, optional) – 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’.
output_table_format (int, [optional for photometry]) – specifies the format of the output table. Must be 1, 2 or 3. Defaults to 1. These options stand for: (1) Data as Published and Homogenized (mJy) (2) Data as Published (3) Homogenized Units (mJy)
from_year (int, [optional for references]) – 4 digit year from which to get the references. Defaults to 1800
to_year (int, [optional for references]) – 4 digit year upto which to fetch the references. Defaults to the current year.
extended_search (bool, [optional for references]) – If set to True, returns all objects beginning with the same identifier name. Defaults to False.
get_query_payload (bool, optional) – if set to True then returns the dictionary sent as the HTTP request. Defaults to False.
verbose (bool, optional.) – When set to True displays warnings if the returned VOTable does not conform to the standard. Defaults to False.

Returns:

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

Return type:

astropy.table.Table

`get_table_async`

Call via MCP

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

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

Serves the same purpose as query_region but returns the raw HTTP response rather than the astropy.table.Table object.

Parameters:

object_name (str) – name of the identifier to query.
table (str, optional) – 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’.
from_year (int, [optional for references]) – 4 digit year from which to get the references. Defaults to 1800
to_year (int, [optional for references]) – 4 digit year upto which to fetch the references. Defaults to the current year.
extended_search (bool, [optional for references]) – If set to True, returns all objects beginning with the same identifier name. Defaults to False.
get_query_payload (bool, optional) – if set to True then returns the dictionary sent as the HTTP request. Defaults to False.

Returns:

response – The HTTP response returned from the service.

Return type:

requests.Response

`query_object`

Call via MCP

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

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

Queries objects by name from the NED Service and returns the Main Source Table.

Parameters:

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

Returns:

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

Return type:

astropy.table.Table

`query_object_async`

Call via MCP

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

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

Serves the same purpose as query_object but returns the raw HTTP response rather than the astropy.table.Table object.

Parameters:

object_name (str) – name of the identifier to query.
get_query_payload (bool, optional) – if set to True then returns the dictionary sent as the HTTP request. Defaults to False

Returns:

response – The HTTP response returned from the service

Return type:

requests.Response

`query_refcode`

Call via MCP

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

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

Used to retrieve all objects contained in a particular reference. Equivalent to by refcode queries of the web interface.

Parameters:

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

Returns:

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

Return type:

astropy.table.Table

`query_refcode_async`

Call via MCP

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

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

Serves the same purpose as query_region but returns the raw HTTP response rather than the astropy.table.Table object.

Parameters:

refcode (str) – 19 digit reference code. Example: 1997A&A…323…31K.
get_query_payload (bool, optional) – if set to True then returns the dictionary sent as the HTTP request. Defaults to False.

Returns:

response – The HTTP response returned from the service.

Return type:

requests.Response

`query_region`

Call via MCP

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

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

Used to query a region around a known identifier or given coordinates. Equivalent to the near position and near name queries from the Ned web interface.

Parameters:

coordinates (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, optional) – The string must be parsable by Angle. The appropriate Quantity object from astropy.units may also be used. Defaults to 1 arcmin.
equinox (str, optional) – The equinox may be either J2000.0 or B1950.0. Defaults to J2000.0
get_query_payload (bool, optional) – if set to True then returns the dictionary sent as the HTTP request. Defaults to False.
verbose (bool, optional.) – When set to True displays warnings if the returned VOTable does not conform to the standard. Defaults to False.

Returns:

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

Return type:

astropy.table.Table

`query_region_async`

Call via MCP

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

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

Serves the same purpose as query_region but returns the raw HTTP response rather than the astropy.table.Table object.

Parameters:

coordinates (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, optional) – 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, optional) – The equinox may be either J2000.0 or B1950.0. Defaults to J2000.0
get_query_payload (bool, optional) – if set to True then returns the dictionary sent as the HTTP request. Defaults to False.

Returns:

response – The HTTP response returned from the service

Return type:

requests.Response

`query_region_iau`

Call via MCP

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

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

Used to query the Ned service via the IAU name. Equivalent to the IAU format queries of the Web interface.

Parameters:

iau_name (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, optional) – May be one of ‘Equatorial’, ‘Ecliptic’, ‘Galactic’, ‘SuperGalactic’. Defaults to ‘Equatorial’.
equinox (str, optional) – The equinox may be one of J2000.0 or B1950.0. Defaults to B1950.0
get_query_payload (bool, optional) – if set to True then returns the dictionary sent as the HTTP request. Defaults to False
verbose (bool, optional.) – When set to True displays warnings if the returned VOTable does not conform to the standard. Defaults to False.

Returns:

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

Return type:

astropy.table.Table

`query_region_iau_async`

Call via MCP

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

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

Serves the same purpose as query_region_iau but returns the raw HTTP response rather than the astropy.table.Table object.

Parameters:

iau_name (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, optional) – May be one of ‘Equatorial’, ‘Ecliptic’, ‘Galactic’, ‘SuperGalactic’. Defaults to ‘Equatorial’.
equinox (str, optional) – The equinox may be one of J2000.0 or B1950.0. Defaults to B1950.0
get_query_payload (bool, optional) – if set to True then returns the dictionary sent as the HTTP request. Defaults to False

Returns:

response – The HTTP response returned from the service.

Return type:

requests.Response

`reset_cache_location`

Call via MCP

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

NedClass.reset_cache_location(): Resets the cache location to the default astropy cache

NED

Functions

clear_cache

get_image_list

get_images

get_images_async

get_spectra

get_spectra_async

get_table

get_table_async

query_object

query_object_async

query_refcode

query_refcode_async

query_region

query_region_async

query_region_iau

query_region_iau_async

reset_cache_location

`clear_cache`

`get_image_list`

`get_images`

`get_images_async`

`get_spectra`

`get_spectra_async`

`get_table`

`get_table_async`

`query_object`

`query_object_async`

`query_refcode`

`query_refcode_async`

`query_region`

`query_region_async`

`query_region_iau`

`query_region_iau_async`

`reset_cache_location`