Package gov.nasa.jpl.aerie.merlin.server.services

Class LocalMissionModelService

java.lang.Object

gov.nasa.jpl.aerie.merlin.server.services.LocalMissionModelService

All Implemented Interfaces:

MissionModelService

public final class LocalMissionModelService
extends Object
implements MissionModelService

Implements the missionModel service MissionModelService interface on a set of local domain objects. May throw unchecked exceptions: * LocalMissionModelService.MissionModelLoadException: When a mission model cannot be loaded from the JAR provided by the connected mission model repository.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	LocalMissionModelService.MissionModelLoadException

Nested classes/interfaces inherited from interface gov.nasa.jpl.aerie.merlin.server.services.MissionModelService

MissionModelService.ActivityInstantiationFailure, MissionModelService.BulkArgumentValidationResponse, MissionModelService.BulkEffectiveArgumentResponse, MissionModelService.NoSuchActivityTypeException, MissionModelService.NoSuchMissionModelException

Constructor Summary

Constructors

Constructor	Description
LocalMissionModelService(Path missionModelDataPath, MissionModelRepository missionModelRepository, Instant untruePlanStart)

Method Summary

Modifier and Type	Method	Description
List<MissionModelService.BulkEffectiveArgumentResponse>	getActivityEffectiveArgumentsBulk(gov.nasa.jpl.aerie.types.MissionModelId missionModelId, List<gov.nasa.jpl.aerie.types.SerializedActivity> serializedActivities)
Map<String,ActivityType>	getActivityTypes(gov.nasa.jpl.aerie.types.MissionModelId missionModelId)	Get information about all activity types in the named mission model.
MissionModelJar	getMissionModelById(gov.nasa.jpl.aerie.types.MissionModelId missionModelId)
Map<gov.nasa.jpl.aerie.types.MissionModelId,MissionModelJar>	getMissionModels()
Map<String,gov.nasa.jpl.aerie.merlin.protocol.types.SerializedValue>	getModelEffectiveArguments(gov.nasa.jpl.aerie.types.MissionModelId missionModelId, Map<String,gov.nasa.jpl.aerie.merlin.protocol.types.SerializedValue> arguments)
List<gov.nasa.jpl.aerie.merlin.protocol.model.InputType.Parameter>	getModelParameters(gov.nasa.jpl.aerie.types.MissionModelId missionModelId)
Map<String,gov.nasa.jpl.aerie.merlin.protocol.types.ValueSchema>	getResourceSchemas(gov.nasa.jpl.aerie.types.MissionModelId missionModelId)
Map<gov.nasa.jpl.aerie.types.MissionModelId,List<ActivityDirectiveForValidation>>	getUnvalidatedDirectives()
void	refreshActivityTypes(gov.nasa.jpl.aerie.types.MissionModelId missionModelId)
void	refreshModelParameters(gov.nasa.jpl.aerie.types.MissionModelId missionModelId)
void	refreshResourceTypes(gov.nasa.jpl.aerie.types.MissionModelId missionModelId)
gov.nasa.jpl.aerie.merlin.driver.SimulationResults	runSimulation(gov.nasa.jpl.aerie.types.Plan plan, Consumer<gov.nasa.jpl.aerie.merlin.protocol.types.Duration> simulationExtentConsumer, Supplier<Boolean> canceledListener, gov.nasa.jpl.aerie.merlin.driver.resources.SimulationResourceManager resourceManager)	Validate that a set of activity parameters conforms to the expectations of a named mission model.
void	updateDirectiveValidations(List<org.apache.commons.lang3.tuple.Pair<ActivityDirectiveForValidation,MissionModelService.BulkArgumentValidationResponse>> updates)
List<gov.nasa.jpl.aerie.merlin.protocol.model.InputType.ValidationNotice>	validateActivityArguments(gov.nasa.jpl.aerie.types.MissionModelId missionModelId, gov.nasa.jpl.aerie.types.SerializedActivity activity)	Validate that a set of activity parameters conforms to the expectations of a named mission model.
List<MissionModelService.BulkArgumentValidationResponse>	validateActivityArgumentsBulk(gov.nasa.jpl.aerie.types.MissionModelId missionModelId, List<ActivityDirectiveForValidation> activities)
Map<gov.nasa.jpl.aerie.types.ActivityDirectiveId,MissionModelService.ActivityInstantiationFailure>	validateActivityInstantiations(gov.nasa.jpl.aerie.types.MissionModelId missionModelId, Map<gov.nasa.jpl.aerie.types.ActivityDirectiveId,gov.nasa.jpl.aerie.types.SerializedActivity> activities)	Validate that a set of activity parameters conforms to the expectations of a named mission model.
List<gov.nasa.jpl.aerie.merlin.protocol.model.InputType.ValidationNotice>	validateModelArguments(gov.nasa.jpl.aerie.types.MissionModelId missionModelId, Map<String,gov.nasa.jpl.aerie.merlin.protocol.types.SerializedValue> arguments)

Methods inherited from class java.lang.Object

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

Constructor Details

LocalMissionModelService

public LocalMissionModelService(Path missionModelDataPath,
 MissionModelRepository missionModelRepository,
 Instant untruePlanStart)

Method Details

getMissionModels

public Map<gov.nasa.jpl.aerie.types.MissionModelId,MissionModelJar> getMissionModels()

Specified by:

getMissionModels in interface MissionModelService

getMissionModelById

public MissionModelJar getMissionModelById(gov.nasa.jpl.aerie.types.MissionModelId missionModelId)
                                    throws MissionModelService.NoSuchMissionModelException

Specified by:

getMissionModelById in interface MissionModelService

Throws:

MissionModelService.NoSuchMissionModelException

getResourceSchemas

public Map<String,gov.nasa.jpl.aerie.merlin.protocol.types.ValueSchema> getResourceSchemas(gov.nasa.jpl.aerie.types.MissionModelId missionModelId)
                                                                                    throws MissionModelService.NoSuchMissionModelException,
LocalMissionModelService.MissionModelLoadException

Specified by:

getResourceSchemas in interface MissionModelService

Throws:

MissionModelService.NoSuchMissionModelException

LocalMissionModelService.MissionModelLoadException

getActivityTypes

public Map<String,ActivityType> getActivityTypes(gov.nasa.jpl.aerie.types.MissionModelId missionModelId)
                                          throws MissionModelService.NoSuchMissionModelException

Get information about all activity types in the named mission model.

Specified by:

getActivityTypes in interface MissionModelService

Parameters:

missionModelId - The ID of the mission model to load.

Returns:

The set of all activity types in the named mission model, indexed by name.

Throws:

MissionModelService.NoSuchMissionModelException - If no mission model is known by the given ID.

validateActivityArguments

public List<gov.nasa.jpl.aerie.merlin.protocol.model.InputType.ValidationNotice> validateActivityArguments(gov.nasa.jpl.aerie.types.MissionModelId missionModelId,
 gov.nasa.jpl.aerie.types.SerializedActivity activity)
                                                                                                    throws MissionModelService.NoSuchMissionModelException,
LocalMissionModelService.MissionModelLoadException,
gov.nasa.jpl.aerie.merlin.protocol.types.InstantiationException

Validate that a set of activity parameters conforms to the expectations of a named mission model.

Specified by:

validateActivityArguments in interface MissionModelService

Parameters:

missionModelId - The ID of the mission model to load.

activity - The serialized activity to validate against the named mission model.

Returns:

A list of validation errors that is empty if validation succeeds.

Throws:

MissionModelService.NoSuchMissionModelException - If no mission model is known by the given ID.

LocalMissionModelService.MissionModelLoadException - If the mission model cannot be loaded -- the JAR may be invalid, or the mission model it contains may not abide by the expected contract at load time.

gov.nasa.jpl.aerie.merlin.protocol.types.InstantiationException

validateActivityArgumentsBulk

public List<MissionModelService.BulkArgumentValidationResponse> validateActivityArgumentsBulk(gov.nasa.jpl.aerie.types.MissionModelId missionModelId,
 List<ActivityDirectiveForValidation> activities)

getUnvalidatedDirectives

public Map<gov.nasa.jpl.aerie.types.MissionModelId,List<ActivityDirectiveForValidation>> getUnvalidatedDirectives()

updateDirectiveValidations

public void updateDirectiveValidations(List<org.apache.commons.lang3.tuple.Pair<ActivityDirectiveForValidation,MissionModelService.BulkArgumentValidationResponse>> updates)

validateActivityInstantiations

public Map<gov.nasa.jpl.aerie.types.ActivityDirectiveId,MissionModelService.ActivityInstantiationFailure> validateActivityInstantiations(gov.nasa.jpl.aerie.types.MissionModelId missionModelId,
 Map<gov.nasa.jpl.aerie.types.ActivityDirectiveId,gov.nasa.jpl.aerie.types.SerializedActivity> activities)
                                                                                                                                  throws MissionModelService.NoSuchMissionModelException,
LocalMissionModelService.MissionModelLoadException

Validate that a set of activity parameters conforms to the expectations of a named mission model.

Specified by:

validateActivityInstantiations in interface MissionModelService

Parameters:

missionModelId - The ID of the mission model to load.

activities - The serialized activities to perform instantiation validation against the named mission model.

Returns:

A map of validation errors mapping activity instance ID to failure message. If validation succeeds the map is empty.

Throws:

MissionModelService.NoSuchMissionModelException

LocalMissionModelService.MissionModelLoadException

getActivityEffectiveArgumentsBulk

public List<MissionModelService.BulkEffectiveArgumentResponse> getActivityEffectiveArgumentsBulk(gov.nasa.jpl.aerie.types.MissionModelId missionModelId,
 List<gov.nasa.jpl.aerie.types.SerializedActivity> serializedActivities)
                                                                                          throws MissionModelService.NoSuchMissionModelException,
LocalMissionModelService.MissionModelLoadException

Specified by:

getActivityEffectiveArgumentsBulk in interface MissionModelService

Throws:

MissionModelService.NoSuchMissionModelException

LocalMissionModelService.MissionModelLoadException

validateModelArguments

public List<gov.nasa.jpl.aerie.merlin.protocol.model.InputType.ValidationNotice> validateModelArguments(gov.nasa.jpl.aerie.types.MissionModelId missionModelId,
 Map<String,gov.nasa.jpl.aerie.merlin.protocol.types.SerializedValue> arguments)
                                                                                                 throws MissionModelService.NoSuchMissionModelException,
LocalMissionModelService.MissionModelLoadException,
gov.nasa.jpl.aerie.merlin.protocol.types.InstantiationException

Specified by:

validateModelArguments in interface MissionModelService

Throws:

MissionModelService.NoSuchMissionModelException

LocalMissionModelService.MissionModelLoadException

gov.nasa.jpl.aerie.merlin.protocol.types.InstantiationException

getModelParameters

public List<gov.nasa.jpl.aerie.merlin.protocol.model.InputType.Parameter> getModelParameters(gov.nasa.jpl.aerie.types.MissionModelId missionModelId)
                                                                                      throws MissionModelService.NoSuchMissionModelException,
LocalMissionModelService.MissionModelLoadException

Specified by:

getModelParameters in interface MissionModelService

Throws:

MissionModelService.NoSuchMissionModelException

LocalMissionModelService.MissionModelLoadException

getModelEffectiveArguments

public Map<String,gov.nasa.jpl.aerie.merlin.protocol.types.SerializedValue> getModelEffectiveArguments(gov.nasa.jpl.aerie.types.MissionModelId missionModelId,
 Map<String,gov.nasa.jpl.aerie.merlin.protocol.types.SerializedValue> arguments)
                                                                                                throws MissionModelService.NoSuchMissionModelException,
LocalMissionModelService.MissionModelLoadException,
gov.nasa.jpl.aerie.merlin.protocol.types.InstantiationException

Specified by:

getModelEffectiveArguments in interface MissionModelService

Throws:

MissionModelService.NoSuchMissionModelException

LocalMissionModelService.MissionModelLoadException

gov.nasa.jpl.aerie.merlin.protocol.types.InstantiationException

runSimulation

public gov.nasa.jpl.aerie.merlin.driver.SimulationResults runSimulation(gov.nasa.jpl.aerie.types.Plan plan,
 Consumer<gov.nasa.jpl.aerie.merlin.protocol.types.Duration> simulationExtentConsumer,
 Supplier<Boolean> canceledListener,
 gov.nasa.jpl.aerie.merlin.driver.resources.SimulationResourceManager resourceManager)
                                                                 throws MissionModelService.NoSuchMissionModelException

Validate that a set of activity parameters conforms to the expectations of a named mission model.

Specified by:

runSimulation in interface MissionModelService

Parameters:

plan - The plan to be simulated. Contains the parameters defining the simulation to perform.

Returns:

A set of samples over the course of the simulation.

Throws:

MissionModelService.NoSuchMissionModelException - If no mission model is known by the given ID.

refreshModelParameters

public void refreshModelParameters(gov.nasa.jpl.aerie.types.MissionModelId missionModelId)
                            throws MissionModelService.NoSuchMissionModelException

Specified by:

refreshModelParameters in interface MissionModelService

Throws:

MissionModelService.NoSuchMissionModelException

refreshActivityTypes

public void refreshActivityTypes(gov.nasa.jpl.aerie.types.MissionModelId missionModelId)
                          throws MissionModelService.NoSuchMissionModelException

Specified by:

refreshActivityTypes in interface MissionModelService

Throws:

MissionModelService.NoSuchMissionModelException

refreshResourceTypes

public void refreshResourceTypes(gov.nasa.jpl.aerie.types.MissionModelId missionModelId)
                          throws MissionModelService.NoSuchMissionModelException,
LocalMissionModelService.MissionModelLoadException

Specified by:

refreshResourceTypes in interface MissionModelService

Throws:

MissionModelService.NoSuchMissionModelException

LocalMissionModelService.MissionModelLoadException