com.dna.jopt.member.bucket.entity

Class Entity

java.lang.Object

com.dna.jopt.member.bucket.entity.Entity

All Implemented Interfaces:

IEntity, Serializable, Cloneable

public class Entity
extends Object
implements IEntity

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Entity()

Method Summary

Modifier and Type	Method and Description
void	addRoute(ILogicEntityRoute logicRoute) Adds an ILogicEntityRoute.
void	addRoute(int index, ILogicEntityRoute logicRoute) Adds a ILogicEntityRoute at the index position, shifting the Route at that position to the right and updating all indexes
IEntity	copy() Copies the current IEntity.
List<ILogicEntityRoute>	exchangeExistingRoutesWithClones(List<ILogicEntityRoute> existingRoutes) Replaces the input ILogicEntityRoutes with clones within the Solution.
ILogicEntityRoute	exchangeExistingRouteWithClone(ILogicEntityRoute existingRoute) Replaces the input ILogicEntityRoute with a clone within the Entity.
boolean	exchangeExistingRouteWithExistingRoute(ILogicEntityRoute existingRouteOrg, ILogicEntityRoute existingRouteReplace) Replaces an ILogicEntityRoute with another ILogicEntityRoute in all the Entities.
List<IOptimizationElement>	getAllEntityElements() Gets all IOptimizationElements of the IEntity.
List<IOptimizationElement>	getAllRoutesElements(String resourceId) Gets all IOptimizationElements Ids who's visiting resource id equal to the input String.
List<ILogicEntityRoute>	getAnchoredRoutes() Returns all ILogicEntityRoute with anchorNodes, which are essentially IPillarNodes overwriting the start or end of a Route.
long	getBuildTimeStamp()
Optional<IOptimizationElement>	getElement(String id)
Optional<IOptimizationElement>	getElement(String id, boolean ignoreStartEnd)
com.dna.jopt.framework.firstentitycreation.IEntityArranger	getEntityArranger() Gets the IEntityArranger, responsible for creating a hard constraints free IEntity.
IEntityCostAndViolationController	getEntityCostAndViolationController() Gets the IEntityCostAndViolationController, responsible for internal cost and IViolations.
IEntityInvokedOperatorController	getEntityInvokedOperatorController() Gets the IEntityInvokedOperatorController.
Optional<ILogicEntityRoute>	getFirstMatchingRoute(INode node) Gets the first ILogicEntityRoute in the Entity which contains the input INode.
Optional<ILogicEntityRoute>	getFirstMatchingRoute(String nodeId) Returns the first ILogicEntityRoute in which the INode or IPillarNode with the input nodeId was found.
double	getJoinedCost() Gets the joined cost which is the accumulated sum of internal cost of all IlogicEntityRoutes of the IEntity.
IJoinedEntityDetailController	getJoinedDetailController() Gets the IJoinedEntityDetailController which is assessing the times and distances of the ILogicEntityRoutes.
IMultiWorkingHoursConstraintController	getMultiWorkingHoursConstraintController() Gets the IMultiWorkingHoursConstraintController which controls the costs for violating IConstraints or IWorkingHours.
List<IOptimizationElement>	getNoneOptimizableElements() Gets all the IOptimizationElements that will not be optimized anymore because they are in the past for example.
List<IOptimizationElement>	getOptimizableElements() Gets all IOptimizationElement of all ILogicEntityRoutes.
IRelationshipController	getRelationshipController() Gets the IRelationshipController, containing the map with the INode2NodeRelations.
Map<IResource,Integer>	getResourceFirstOccurenceAbsoluteIndexMap()
ILogicEntityRoute	getRoute(int index) Gets the ILogicEntityRoute according to the index.
int	getRouteCount() Gets the current number of Routes.
ListIterator<ILogicEntityRoute>	getRouteIterator() Gets the route iterator.
List<ILogicEntityRoute>	getRoutes() Gets the whole list of ILogicEntityRoutes.
List<ILogicEntityRoute>	getRoutesByResource(IResource res)
List<ILogicEntityRoute>	getRoutesContainingElementId(String elementId)
List<ILogicEntityRoute>	getRoutesContainingElementId(String elementId, boolean ignoreStartEnd)
Optional<ILogicEntityRoute>	getRoutesContainingElementId(String elementId, String visitor, boolean ignoreStartEnd)
List<IViolationSummary>	getRouteViolationSummaries() Gets the all of the IViolations in the IEntity and summarizes them in an IViolationSummary.
int	getTotalRoutesDistinctElementsCount() Gets the number of all IOptimizationElement.
int	getTotalRoutesOptimizableElementsCount() Gets the total number of IOptimizationElements within the ILogicEntityRoutes.
boolean	hasNode(String nodeId) Checks if a INode or IPIllarNode contains the input Id.
boolean	hasResource(String resourceId) Check if a IResource contains the input Id.
boolean	isUnassessed() Checks whether the IEntity is unassessed, the default value is true.
IEntity	partialCopy(List<ILogicEntityRoute> routes2BeCopied) Returns an IEntity in which only the input ILogicEntityRoutes are actual copies, the rest of the IEntity consists of references to the original Object.
IEntity	partialCopyExchangeExistingRoute(ILogicEntityRoute existingRouteOrg, ILogicEntityRoute existingRouteReplace)
void	removeRoute(ILogicEntityRoute remRoute) Removes an ILogicEntityRoute from an IEntity.
void	removeRoute(int index) Removes an ILogicEntityRoute from an IEntity by the index number.
void	setEntityArranger(com.dna.jopt.framework.firstentitycreation.IEntityArranger entityArranger) Sets the IEntityArranger.
void	setEntityCostAndViolationController(IEntityCostAndViolationController controller) Sets the IEntityCostAndViolationController responsible for internal cost and IViolations.
void	setEntityInvokedOperatorController(IEntityInvokedOperatorController opc) Sets the IEntityInvokedOperatorController which holds information on cost advantage of the last used Operator etc.
void	setIsRequestAllRoutesElementDetails(boolean requestAllElementDetails) Sets the resultrequested value of all ILogicEntityRoutes.
void	setIsUnassessed(boolean isUnassessed) Sets the unassessed status.
void	setJoinedCost(double cost) Sets the joined cost which is the accumulated sum of internal cost of all IlogicEntityRoutes of the IEntity.
void	setJoinedDetailController(IJoinedEntityDetailController joinedDetailController) Sets the IJoinedEntityDetailController which is assessing the times and distances of the ILogicEntityRoutes.
void	setMultiWorkingHoursConstraintController(IMultiWorkingHoursConstraintController controller) Sets the IMultiWorkingHoursConstraintController which controls the costs for violating IConstraints or IWorkingHours.
void	setRelationShipController(IRelationshipController controller) Sets the IRelationshipController, containing the map with the INode2NodeRelation.
void	setRoutes(List<ILogicEntityRoute> routes) Sets the input ILogicEntityRoute as the ILogicEntityRoutes of an IEntity .
String	toOverviewResult() Prints the result of the IOptimization with the number of ILogicEntityRoute, number of IOptimizationElement, total time, distance, idle time etc.
String	toString() Returns a String representing the IEntity object.
String	toString(boolean showNonSchedudledRoutes)
void	updateJointEntityBaseValueWithOwnRoutes() Instantiates a new IJoinedEntityDetailController and adds the values of all ILogicEntityRoute that were not unassigned.
void	updateJointEntityBaseValueWithRoute(ILogicEntityRoute route) Adds the value of distance, idle time, productive time, transit time etc of the input ILogicEntityRoute to the IJoinedEntityDetailController of the IEntity.

Methods inherited from class java.lang.Object

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

Constructor Detail

Entity

public Entity()

Method Detail

getBuildTimeStamp

public long getBuildTimeStamp()

Specified by:

getBuildTimeStamp in interface IEntity

setIsUnassessed

public void setIsUnassessed(boolean isUnassessed)

Description copied from interface: IEntity

Sets the unassessed status.

Being marked as unassessed means that this Object will have to go through assessment again. For complete solutions the ILogicEntityRoutes and all IEntities have to be assessed. When an INode is shifted from one Route to another by an IOperator the respective Routes and Entity need to be marked as unassessed in order to get assessed again updating their costs since they might have changed. An Entity also needs to be set as unassessed when IEntity.setIsRequestAllRoutesElementDetails(boolean) is set to true. By doing this the Routes will automatically be set to unassessed since they need to go through a new assessment in order to save the ILogicRouteElementDetailItem

Specified by:

setIsUnassessed in interface IEntity

Parameters:

isUnassessed - the boolean to set

isUnassessed

public boolean isUnassessed()

Description copied from interface: IEntity

Checks whether the IEntity is unassessed, the default value is true.

Specified by:

isUnassessed in interface IEntity

Returns:

the set value

setRelationShipController

public void setRelationShipController(IRelationshipController controller)

Description copied from interface: IEntity

Sets the IRelationshipController, containing the map with the INode2NodeRelation.

Specified by:

setRelationShipController in interface IEntity

Parameters:

controller - the iRelationshipController to set

getRelationshipController

public IRelationshipController getRelationshipController()

Description copied from interface: IEntity

Gets the IRelationshipController, containing the map with the INode2NodeRelations.

Specified by:

getRelationshipController in interface IEntity

Returns:

details on the relationship

setMultiWorkingHoursConstraintController

public void setMultiWorkingHoursConstraintController(IMultiWorkingHoursConstraintController controller)

Description copied from interface: IEntity

Sets the IMultiWorkingHoursConstraintController which controls the costs for violating IConstraints or IWorkingHours.

Specified by:

setMultiWorkingHoursConstraintController in interface IEntity

Parameters:

controller - the iMultiWorkingHoursConstraintController to set

getMultiWorkingHoursConstraintController

public IMultiWorkingHoursConstraintController getMultiWorkingHoursConstraintController()

Description copied from interface: IEntity

Gets the IMultiWorkingHoursConstraintController which controls the costs for violating IConstraints or IWorkingHours.

Specified by:

getMultiWorkingHoursConstraintController in interface IEntity

Returns:

the IMultiWorkingHoursConstraintController

setJoinedCost

public void setJoinedCost(double cost)

Description copied from interface: IEntity

Sets the joined cost which is the accumulated sum of internal cost of all IlogicEntityRoutes of the IEntity.

Specified by:

setJoinedCost in interface IEntity

Parameters:

cost - the double internal costs of the whole IEntity

getJoinedCost

public double getJoinedCost()

Description copied from interface: IEntity

Gets the joined cost which is the accumulated sum of internal cost of all IlogicEntityRoutes of the IEntity.

Specified by:

getJoinedCost in interface IEntity

Returns:

the total of internal costs of the IEntity

getEntityCostAndViolationController

public IEntityCostAndViolationController getEntityCostAndViolationController()

Description copied from interface: IEntity

Gets the IEntityCostAndViolationController, responsible for internal cost and IViolations.

Specified by:

getEntityCostAndViolationController in interface IEntity

Returns:

the IEntityCostAndViolationController

setEntityCostAndViolationController

public void setEntityCostAndViolationController(IEntityCostAndViolationController controller)

Description copied from interface: IEntity

Sets the IEntityCostAndViolationController responsible for internal cost and IViolations.

Specified by:

setEntityCostAndViolationController in interface IEntity

Parameters:

controller - the iEntityCostAndViolationController

addRoute

public void addRoute(ILogicEntityRoute logicRoute)

Description copied from interface: IEntity

Adds an ILogicEntityRoute.

Specified by:

addRoute in interface IEntity

Parameters:

logicRoute - the route

addRoute

public void addRoute(int index,
                     ILogicEntityRoute logicRoute)

Description copied from interface: IEntity

Adds a ILogicEntityRoute at the index position, shifting the Route at that position to the right and updating all indexes

Specified by:

addRoute in interface IEntity

Parameters:

index - the int index which the Route will have

logicRoute - the iLogicEntityRoute to add

removeRoute

public void removeRoute(ILogicEntityRoute remRoute)

Description copied from interface: IEntity

Removes an ILogicEntityRoute from an IEntity.

Specified by:

removeRoute in interface IEntity

Parameters:

remRoute - the route to remove

removeRoute

public void removeRoute(int index)

Description copied from interface: IEntity

Removes an ILogicEntityRoute from an IEntity by the index number.

Specified by:

removeRoute in interface IEntity

Parameters:

index - the int index

setIsRequestAllRoutesElementDetails

public void setIsRequestAllRoutesElementDetails(boolean requestAllElementDetails)

Description copied from interface: IEntity

Sets the resultrequested value of all ILogicEntityRoutes. If set to true the ILogicRouteElementDetailItems are getting saved.

Specified by:

setIsRequestAllRoutesElementDetails in interface IEntity

Parameters:

requestAllElementDetails - the boolean to set

getRouteIterator

public ListIterator<ILogicEntityRoute> getRouteIterator()

Description copied from interface: IEntity

Gets the route iterator.

Specified by:

getRouteIterator in interface IEntity

Returns:

the route iterator

getRouteCount

public int getRouteCount()

Description copied from interface: IEntity

Gets the current number of Routes.

Specified by:

getRouteCount in interface IEntity

Returns:

the route count

See Also:

IEntity.addRoute(ILogicEntityRoute)

getRoute

public ILogicEntityRoute getRoute(int index)

Description copied from interface: IEntity

Gets the ILogicEntityRoute according to the index.

Specified by:

getRoute in interface IEntity

Parameters:

index - the int index

Returns:

the iLogicEntityRoute route

setRoutes

public void setRoutes(List<ILogicEntityRoute> routes)

Description copied from interface: IEntity

Sets the input ILogicEntityRoute as the ILogicEntityRoutes of an IEntity . This method should ONLY be used for copy/clone. In addition this method is not adapting the tutorEntity automatically. This has to be done externally.

Specified by:

setRoutes in interface IEntity

Parameters:

routes - the iLogicEntityRoutes that are copied to the copy of the IEntity

getTotalRoutesOptimizableElementsCount

public int getTotalRoutesOptimizableElementsCount()

Description copied from interface: IEntity

Gets the total number of IOptimizationElements within the ILogicEntityRoutes.

Specified by:

getTotalRoutesOptimizableElementsCount in interface IEntity

Returns:

the total route element count

getTotalRoutesDistinctElementsCount

public int getTotalRoutesDistinctElementsCount()

Description copied from interface: IEntity

Gets the number of all IOptimizationElement.

Specified by:

getTotalRoutesDistinctElementsCount in interface IEntity

Returns:

the number of Elements in all the Route

getRoutes

public List<ILogicEntityRoute> getRoutes()

Description copied from interface: IEntity

Gets the whole list of ILogicEntityRoutes.

Specified by:

getRoutes in interface IEntity

Returns:

all the routes in the IEntity

exchangeExistingRouteWithExistingRoute

public boolean exchangeExistingRouteWithExistingRoute(ILogicEntityRoute existingRouteOrg,
                                                      ILogicEntityRoute existingRouteReplace)

Description copied from interface: IEntity

Replaces an ILogicEntityRoute with another ILogicEntityRoute in all the Entities.

This is used in lockdown.

Specified by:

exchangeExistingRouteWithExistingRoute in interface IEntity

Parameters:

existingRouteOrg - the iLogicEntityRoute to replace

existingRouteReplace - the ILogicEntityRoute that will be put in its stead

Returns:

true if the operation was successful

exchangeExistingRouteWithClone

public ILogicEntityRoute exchangeExistingRouteWithClone(ILogicEntityRoute existingRoute)

Description copied from interface: IEntity

Replaces the input ILogicEntityRoute with a clone within the Entity.

Specified by:

exchangeExistingRouteWithClone in interface IEntity

Parameters:

existingRoute - the iLogicEntityRoute that is replaced with a copy

Returns:

the cloned ILogicEntityRoute

exchangeExistingRoutesWithClones

public List<ILogicEntityRoute> exchangeExistingRoutesWithClones(List<ILogicEntityRoute> existingRoutes)

Description copied from interface: IEntity

Replaces the input ILogicEntityRoutes with clones within the Solution.

Specified by:

exchangeExistingRoutesWithClones in interface IEntity

Parameters:

existingRoutes - the iLogicEntityRoutes that are replaced with a copy

Returns:

the copied list of the input

partialCopy

public IEntity partialCopy(List<ILogicEntityRoute> routes2BeCopied)

Description copied from interface: IEntity

Returns an IEntity in which only the input ILogicEntityRoutes are actual copies, the rest of the IEntity consists of references to the original Object. This shallow copy allows to make modifications to the respective Routes of an IEntity while demanding less performance than a full copy.

Specified by:

partialCopy in interface IEntity

Parameters:

routes2BeCopied - the iLogicEntityRoutes which are copied

Returns:

an Object containing references to the original IEntity while the input Routes are copies

partialCopyExchangeExistingRoute

public IEntity partialCopyExchangeExistingRoute(ILogicEntityRoute existingRouteOrg,
                                                ILogicEntityRoute existingRouteReplace)

Specified by:

partialCopyExchangeExistingRoute in interface IEntity

copy

public IEntity copy()

Description copied from interface: IEntity

Copies the current IEntity.

Specified by:

copy in interface IEntity

Returns:

the copy of the IEntity

toOverviewResult

public String toOverviewResult()

Description copied from interface: IEntity

Prints the result of the IOptimization with the number of ILogicEntityRoute, number of IOptimizationElement, total time, distance, idle time etc.

Specified by:

toOverviewResult in interface IEntity

Returns:

an overview of the result

toString

public String toString()

Description copied from interface: IEntity

Returns a String representing the IEntity object.

Some information is given on the ILogicEntityRoutes like the productive time and the idle time.

Specified by:

toString in interface IEntity

Overrides:

toString in class Object

Returns:

the string representation

toString

public String toString(boolean showNonSchedudledRoutes)

Specified by:

toString in interface IEntity

getJoinedDetailController

public IJoinedEntityDetailController getJoinedDetailController()

Description copied from interface: IEntity

Gets the IJoinedEntityDetailController which is assessing the times and distances of the ILogicEntityRoutes.

Specified by:

getJoinedDetailController in interface IEntity

Returns:

the IJoinedEntityDetailController

setJoinedDetailController

public void setJoinedDetailController(IJoinedEntityDetailController joinedDetailController)

Description copied from interface: IEntity

Sets the IJoinedEntityDetailController which is assessing the times and distances of the ILogicEntityRoutes.

Specified by:

setJoinedDetailController in interface IEntity

Parameters:

joinedDetailController - the iJoinedEntityDetailController to set

getRouteViolationSummaries

public List<IViolationSummary> getRouteViolationSummaries()

Description copied from interface: IEntity

Gets the all of the IViolations in the IEntity and summarizes them in an IViolationSummary.

Specified by:

getRouteViolationSummaries in interface IEntity

Returns:

the summarized IViolations

setEntityArranger

public void setEntityArranger(com.dna.jopt.framework.firstentitycreation.IEntityArranger entityArranger)

Description copied from interface: IEntity

Sets the IEntityArranger.

Specified by:

setEntityArranger in interface IEntity

Parameters:

entityArranger - the iEntityArranger

getEntityArranger

public com.dna.jopt.framework.firstentitycreation.IEntityArranger getEntityArranger()

Description copied from interface: IEntity

Gets the IEntityArranger, responsible for creating a hard constraints free IEntity.

Specified by:

getEntityArranger in interface IEntity

Returns:

the IEntityArranger

getEntityInvokedOperatorController

public IEntityInvokedOperatorController getEntityInvokedOperatorController()

Description copied from interface: IEntity

Gets the IEntityInvokedOperatorController.

Specified by:

getEntityInvokedOperatorController in interface IEntity

Returns:

the IEntityInvokedOperatorController which holds information on cost advantage of the last Operator etc.

setEntityInvokedOperatorController

public void setEntityInvokedOperatorController(IEntityInvokedOperatorController opc)

Description copied from interface: IEntity

Sets the IEntityInvokedOperatorController which holds information on cost advantage of the last used Operator etc.

Specified by:

setEntityInvokedOperatorController in interface IEntity

Parameters:

opc - the iEntityInvokedOperatorController

updateJointEntityBaseValueWithRoute

public void updateJointEntityBaseValueWithRoute(ILogicEntityRoute route)

Description copied from interface: IEntity

Adds the value of distance, idle time, productive time, transit time etc of the input ILogicEntityRoute to the IJoinedEntityDetailController of the IEntity.

Specified by:

updateJointEntityBaseValueWithRoute in interface IEntity

Parameters:

route - the iLogicEntityRoute of which the values should be added

updateJointEntityBaseValueWithOwnRoutes

public void updateJointEntityBaseValueWithOwnRoutes()

Description copied from interface: IEntity

Instantiates a new IJoinedEntityDetailController and adds the values of all ILogicEntityRoute that were not unassigned.

Specified by:

updateJointEntityBaseValueWithOwnRoutes in interface IEntity

getAllEntityElements

public List<IOptimizationElement> getAllEntityElements()

Description copied from interface: IEntity

Gets all IOptimizationElements of the IEntity.

Specified by:

getAllEntityElements in interface IEntity

Returns:

all IOptimizationElements

getAllRoutesElements

public List<IOptimizationElement> getAllRoutesElements(String resourceId)

Description copied from interface: IEntity

Gets all IOptimizationElements Ids who's visiting resource id equal to the input String.

Specified by:

getAllRoutesElements in interface IEntity

Parameters:

resourceId - the string to search for

Returns:

the search results containing the input

getResourceFirstOccurenceAbsoluteIndexMap

public Map<IResource,Integer> getResourceFirstOccurenceAbsoluteIndexMap()

Specified by:

getResourceFirstOccurenceAbsoluteIndexMap in interface IEntity

getFirstMatchingRoute

public Optional<ILogicEntityRoute> getFirstMatchingRoute(String nodeId)

Description copied from interface: IEntity

Returns the first ILogicEntityRoute in which the INode or IPillarNode with the input nodeId was found.

Specified by:

getFirstMatchingRoute in interface IEntity

Parameters:

nodeId - the string Id of the Node to look for.

Returns:

the Route in which the Node or Pillar was found.

getRoutesByResource

public List<ILogicEntityRoute> getRoutesByResource(IResource res)

Specified by:

getRoutesByResource in interface IEntity

getAnchoredRoutes

public List<ILogicEntityRoute> getAnchoredRoutes()

Description copied from interface: IEntity

Returns all ILogicEntityRoute with anchorNodes, which are essentially IPillarNodes overwriting the start or end of a Route.

Specified by:

getAnchoredRoutes in interface IEntity

Returns:

the list of Routes with anchorNodes

getFirstMatchingRoute

public Optional<ILogicEntityRoute> getFirstMatchingRoute(INode node)

Description copied from interface: IEntity

Gets the first ILogicEntityRoute in the Entity which contains the input INode.

Specified by:

getFirstMatchingRoute in interface IEntity

Parameters:

node - the iNode to look for

Returns:

the first found Route containing the Node

hasResource

public boolean hasResource(String resourceId)

Description copied from interface: IEntity

Check if a IResource contains the input Id.

Specified by:

hasResource in interface IEntity

Parameters:

resourceId - the string Id to search for

Returns:

true if a Resource containing this Id exists

hasNode

public boolean hasNode(String nodeId)

Description copied from interface: IEntity

Checks if a INode or IPIllarNode contains the input Id.

Specified by:

hasNode in interface IEntity

Parameters:

nodeId - the string Id to search for

Returns:

true if any of the Elements contains the Id

getRoutesContainingElementId

public List<ILogicEntityRoute> getRoutesContainingElementId(String elementId)

Specified by:

getRoutesContainingElementId in interface IEntity

getRoutesContainingElementId

public List<ILogicEntityRoute> getRoutesContainingElementId(String elementId,
                                                            boolean ignoreStartEnd)

Specified by:

getRoutesContainingElementId in interface IEntity

getRoutesContainingElementId

public Optional<ILogicEntityRoute> getRoutesContainingElementId(String elementId,
                                                                String visitor,
                                                                boolean ignoreStartEnd)

Specified by:

getRoutesContainingElementId in interface IEntity

getNoneOptimizableElements

public List<IOptimizationElement> getNoneOptimizableElements()

Description copied from interface: IEntity

Gets all the IOptimizationElements that will not be optimized anymore because they are in the past for example.

Specified by:

getNoneOptimizableElements in interface IEntity

Returns:

the list of noneOptimizableElements

getOptimizableElements

public List<IOptimizationElement> getOptimizableElements()

Description copied from interface: IEntity

Gets all IOptimizationElement of all ILogicEntityRoutes.

Specified by:

getOptimizableElements in interface IEntity

Returns:

all optimizable Elements

getElement

public Optional<IOptimizationElement> getElement(String id)

Specified by:

getElement in interface IEntity

getElement

public Optional<IOptimizationElement> getElement(String id,
                                                 boolean ignoreStartEnd)

Specified by:

getElement in interface IEntity