Class TrialExperiment

java.lang.Object

org.episteme.core.methodology.ScientificExperiment<Void, Set<ValuedVariable>>

org.episteme.natural.methodology.experiment.TrialExperiment

All Implemented Interfaces:

Serializable, Experiment<Void, Set<ValuedVariable>>, Commented, ComprehensiveIdentification, Identified<Identification>, Named, UniversalDataModel

public class TrialExperiment
extends ScientificExperiment<Void, Set<ValuedVariable>>

A class representing a scientific experiment involving subjects, tasks, and variables.

This class specializes ScientificExperiment for experimental designs common in psychology, biology, and social sciences.

Since:

1.0

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
TrialExperiment(String name)
TrialExperiment(String name, String description)

Method Summary

Modifier and Type	Method	Description
Subject	addSubject(Individual individual, List<Task> tasks)	Adds a subject to the experiment.
Hypothesis<Set<ValuedVariable>>	getHypothesis()	Gets the hypothesis this experiment aims to test.
int	getNumSubjects()
Set<Subject>	getSubjects()	Gets all subjects involved in the experiment.
Set<Task>	getTasks()	Gets all tasks defined across all subjects.
boolean	isExperimentComplete()
CompletableFuture<Set<ValuedVariable>>	run(Void input)	Executes the experiment with the given input.

Methods inherited from class ScientificExperiment

addAuthor, addReference, getAuthors, getDescription, getEndDate, getId, getMetadata, getModelType, getName, getObservations, getQuantities, getReferences, getStartDate, getTraits, record, setDescription, setEndDate, setName, setStartDate

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

TrialExperiment

public TrialExperiment(String name)

TrialExperiment

public TrialExperiment(String name,
 String description)

Method Details

getSubjects

public Set<Subject> getSubjects()

Gets all subjects involved in the experiment.

getNumSubjects

public int getNumSubjects()

addSubject

public Subject addSubject(Individual individual,
 List<Task> tasks)

Adds a subject to the experiment.

Parameters:

individual - The individual to add.

tasks - The tasks assigned to this individual in this experiment.

Returns:

The created Subject.

isExperimentComplete

public boolean isExperimentComplete()

getTasks

public Set<Task> getTasks()

Gets all tasks defined across all subjects.

run

public CompletableFuture<Set<ValuedVariable>> run(Void input)

Description copied from interface: Experiment

Executes the experiment with the given input.

Specified by:

run in interface Experiment<Void, Set<ValuedVariable>>

Overrides:

run in class ScientificExperiment<Void, Set<ValuedVariable>>

Parameters:

input - the experimental parameters

Returns:

a future providing the result

getHypothesis

public Hypothesis<Set<ValuedVariable>> getHypothesis()

Description copied from interface: Experiment

Gets the hypothesis this experiment aims to test.

Specified by:

getHypothesis in interface Experiment<Void, Set<ValuedVariable>>

Overrides:

getHypothesis in class ScientificExperiment<Void, Set<ValuedVariable>>

Returns:

the hypothesis, or null if exploratory