Class ScientificExperiment<I,R>

java.lang.Object

org.episteme.core.methodology.ScientificExperiment<I,R>

Type Parameters:

I - The input configuration type

R - The result type

All Implemented Interfaces:

Serializable, Experiment<I,R>, Commented, ComprehensiveIdentification, Identified<Identification>, Named, UniversalDataModel

Direct Known Subclasses:

TrialExperiment

public class ScientificExperiment<I,R>
extends Object
implements Experiment<I,R>, UniversalDataModel

A robust, persistent implementation of the Experiment interface.

This class serves as a base for specific scientific experiments (e.g., in Psychology, Physics). It includes support for authorship, bibliographic references, and observation tracking.

Since:

1.0

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
ScientificExperiment(String name)	Creates a new Scientific Experiment.

Method Summary

Modifier and Type	Method	Description
void	addAuthor(String author)
void	addReference(Citation citation)
List<String>	getAuthors()
String	getDescription()
Instant	getEndDate()
Hypothesis<R>	getHypothesis()	Gets the hypothesis this experiment aims to test.
Identification	getId()	Returns the unique identifier of this entity.
Map<String,Object>	getMetadata()	Returns a map of metadata for this model (e.g., creation date, source).
String	getModelType()	Returns a unique identifier for the type of data model.
String	getName()
List<Observation<R>>	getObservations()
Map<String, Quantity<?>>	getQuantities()	Returns the primary physical values associated with this model.
List<Citation>	getReferences()
Instant	getStartDate()
Map<String,Object>	getTraits()	Returns the traits map for this entity.
void	record(Observation<R> observation)	Records an observation derived from the experiment execution.
CompletableFuture<R>	run(I input)	Executes the experiment with the given input.
void	setDescription(String description)
void	setEndDate(Instant endDate)
void	setName(String name)	Sets the name of this entity.
void	setStartDate(Instant startDate)

Methods inherited from class Object

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

Methods inherited from interface Commented

getComments, getTrait, setComments

Methods inherited from interface ComprehensiveIdentification

getTrait, setTrait

Methods inherited from interface UniversalDataModel

validate

Constructor Details

ScientificExperiment

public ScientificExperiment(String name)

Creates a new Scientific Experiment.

Parameters:

name - The name of the experiment.

Method Details

run

public CompletableFuture<R> run(I input)

Description copied from interface: Experiment

Executes the experiment with the given input.

Specified by:

run in interface Experiment<I,R>

Parameters:

input - the experimental parameters

Returns:

a future providing the result

getHypothesis

public Hypothesis<R> getHypothesis()

Description copied from interface: Experiment

Gets the hypothesis this experiment aims to test.

Specified by:

getHypothesis in interface Experiment<I,R>

Returns:

the hypothesis, or null if exploratory

getTraits

public Map<String,Object> getTraits()

Description copied from interface: ComprehensiveIdentification

Returns the traits map for this entity.

Specified by:

getTraits in interface Commented

Specified by:

getTraits in interface ComprehensiveIdentification

Returns:

the traits map

getId

public Identification getId()

Description copied from interface: Identified

Returns the unique identifier of this entity.

Specified by:

getId in interface Experiment<I,R>

Specified by:

getId in interface Identified<I>

Returns:

the identifier

getName

public String getName()

Specified by:

getName in interface ComprehensiveIdentification

Specified by:

getName in interface Experiment<I,R>

Specified by:

getName in interface Named

setName

public void setName(String name)

Description copied from interface: ComprehensiveIdentification

Sets the name of this entity.

Specified by:

setName in interface ComprehensiveIdentification

Parameters:

name - the name to set

getDescription

public String getDescription()

setDescription

public void setDescription(String description)

getAuthors

public List<String> getAuthors()

addAuthor

public void addAuthor(String author)

getReferences

public List<Citation> getReferences()

addReference

public void addReference(Citation citation)

getObservations

public List<Observation<R>> getObservations()

record

public void record(Observation<R> observation)

Records an observation derived from the experiment execution.

getStartDate

public Instant getStartDate()

setStartDate

public void setStartDate(Instant startDate)

getEndDate

public Instant getEndDate()

setEndDate

public void setEndDate(Instant endDate)

getModelType

public String getModelType()

Description copied from interface: UniversalDataModel

Returns a unique identifier for the type of data model. Examples: "SPATIAL_GEOMETRY", "ECONOMIC_PORTFOLIO", "ARCHITECTURAL_PLAN".

Specified by:

getModelType in interface UniversalDataModel

getMetadata

public Map<String,Object> getMetadata()

Description copied from interface: UniversalDataModel

Returns a map of metadata for this model (e.g., creation date, source).

Specified by:

getMetadata in interface UniversalDataModel

getQuantities

public Map<String, Quantity<?>> getQuantities()

Description copied from interface: UniversalDataModel

Returns the primary physical values associated with this model. This allows generic tools to extract and convert measurements.

Specified by:

getQuantities in interface UniversalDataModel