Class SIMBADReader

java.lang.Object

org.episteme.core.io.AbstractResourceReader<SIMBADReader.AstronomicalObject>

org.episteme.natural.physics.loaders.SIMBADReader

All Implemented Interfaces:

ResourceIO<SIMBADReader.AstronomicalObject>, ResourceReader<SIMBADReader.AstronomicalObject>

public class SIMBADReader
extends AbstractResourceReader<SIMBADReader.AstronomicalObject>

Loader for SIMBAD astronomical database.

Fetches astronomical object data from CDS SIMBAD. Uses the Sesame name resolver for object identification.

Since:

1.0

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

See Also:

• SIMBAD Database

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SIMBADReader.AstronomicalObject	Represents an astronomical object from SIMBAD.

Constructor Summary

Constructors

Constructor	Description
SIMBADReader()

Method Summary

Modifier and Type	Method	Description
String	getCategory()	Returns the category for grouping.
String	getDescription()	Returns a short description of this resource handler.
String	getLongDescription()	Returns a long description of this resource handler.
String	getName()	Returns the display name of this resource handler.
String	getResourcePath()	Returns the base path where this resource is located.
Class<SIMBADReader.AstronomicalObject>	getResourceType()	Returns the type of resource.
String[]	getSupportedVersions()	Returns the supported versions of the format this reader/writer handles.
protected SIMBADReader.AstronomicalObject	loadFromSource(String id)
Optional<SIMBADReader.AstronomicalObject>	resolveByName(String name)	Resolves an object name using Sesame name resolver.
List<SIMBADReader.AstronomicalObject>	searchByCoordinates(double ra, double dec, double radiusArcmin, int limit)	Searches for objects within a radius around coordinates.

Methods inherited from class AbstractResourceReader

clearCache, getMiniCatalog, getSampleDataPath, isUsingFallback, load, loadAll, loadAllFromSource, loadFromFallback, loadFromInputStream, setCacheEnabled

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface ResourceIO

getExpectedResourceFiles, getSupportedExtensions, isFileBased, isOutput

Methods inherited from interface ResourceReader

isInput

Constructor Details

SIMBADReader

public SIMBADReader()

Method Details

loadFromSource

protected SIMBADReader.AstronomicalObject loadFromSource(String id)
                                                  throws Exception

Specified by:

loadFromSource in class AbstractResourceReader<SIMBADReader.AstronomicalObject>

Throws:

Exception

getResourcePath

public String getResourcePath()

Description copied from interface: ResourceIO

Returns the base path where this resource is located.

getResourceType

public Class<SIMBADReader.AstronomicalObject> getResourceType()

Description copied from interface: ResourceIO

Returns the type of resource.

getSupportedVersions

public String[] getSupportedVersions()

Description copied from interface: ResourceIO

Returns the supported versions of the format this reader/writer handles.

Each implementation MUST override this method to declare which versions of the underlying format are supported. The returned array should contain version strings in the format's standard notation (e.g., "3.0", "2.1", "Level 3 Version 2").

Examples:

• MathML: {"3.0", "2.0"}
• SBML: {"Level 3 Version 2", "Level 3 Version 1", "Level 2 Version 5"}
• PhyloXML: {"1.10", "1.00"}

Returns:

array of supported version strings, never null (empty array if version-agnostic)

getCategory

public String getCategory()

Description copied from interface: ResourceIO

Returns the category for grouping. MUST be implemented with I18N support.

Returns:

the category name

getDescription

public String getDescription()

Description copied from interface: ResourceIO

Returns a short description of this resource handler. MUST be implemented with I18N support.

Returns:

the description

getLongDescription

public String getLongDescription()

Description copied from interface: ResourceIO

Returns a long description of this resource handler. MUST be implemented with I18N support.

Returns:

the long description

resolveByName

public Optional<SIMBADReader.AstronomicalObject> resolveByName(String name)

Resolves an object name using Sesame name resolver.

Parameters:

name - the object name (e.g., "M31", "Betelgeuse", "HD 48915")

Returns:

the resolved object, or empty if not found

searchByCoordinates

public List<SIMBADReader.AstronomicalObject> searchByCoordinates(double ra,
 double dec,
 double radiusArcmin,
 int limit)

Searches for objects within a radius around coordinates.

Parameters:

ra - Right Ascension in degrees

dec - Declination in degrees

radiusArcmin - search radius in arcminutes

limit - maximum results

Returns:

list of objects found

getName

public String getName()

Description copied from interface: ResourceIO

Returns the display name of this resource handler. MUST be implemented with I18N support.

Returns:

the display name