DowntimeEntity

The DowntimeEntity object is used to generate planned and unplanned maintenance events for various types of objects.  The DowntimeEntity generates the downtime events and their durations, but the objects that use one or more DowntimeEntities must provide their own logic for halting operations.

In some cases, there can be a delay before object using the DowntimeEntity initiates the downtime activity.  This can occur when an object such as a Server uses the DowntimeEntity in its OpportunisticMaintenanceList or OpportunisticBreakdownList inputs.  The NumberPending output for the DowntimeEntity returns the number of downtime events that are ready to start, but have not started yet.

DowntimeEntity Inputs

Keyword

Description

Key Inputs

 

Description

A free-form string describing the object.

FirstDowntime

The calendar or working time for the first planned or unplanned maintenance event.  If an input is not provided, the first maintenance event is determined by the input for the Interval keyword.  A number, an object that returns a number, or an expression can be entered.

IntervalWorkingEntity

The object whose working time determines the occurrence of the planned or unplanned maintenance events.  Calendar time is used if the input is left blank.

DurationWorkingEntity

The object whose working time determines the completion of the planned or unplanned maintenance activity.  Calendar time is used if the input is left blank.

Interval

The calendar or working time between the start of the last planned or unplanned maintenance activity and the start of the next maintenance activity.  A number, an expression, or an object that returns a number can be entered.

Duration

The calendar or working time required to complete the planned or unplanned maintenance activity.  A number, an expression, or an object that returns a number can be entered.

Concurrent

If TRUE, the downtime event can occur in parallel with another downtime event.

MaxDowntimePending

The maximum number of downtimes pending for the downtime event.

Options

 

AttributeDefinitionList, CustomOutputList

See Section 6.2.

Graphics

 

Position, Alignment, Size, Orientation, Region, RelativeEntity, DisplayModel, Show, Movable, VisibleViews, DrawRange

See Section 11.1.

DowntimeEntity Outputs

Output Name

Description

Entity and DisplayEntity

 

Name, ObjectType, SimTime, Parent, Position, Size, Orientation, Alignment, GraphicalLength, ObserverList, NextList, PreviousList, EntityReferenceList

See Section 11.1.

StateEntity

 

State, WorkingState, WorkingTime, StateTimes, TotalTime

See Section 10.3.

DownTimeEntity

 

UserList

The objects that experience breakdowns or maintenance caused by this DowntimeEntity.

NumberPending

The number of downtime events that are backlogged.  If two or more downtime events are pending they will be performed one after another.

StartTime

The time that the most recent downtime event started.

EndTime

The time that the most recent downtime event finished or will finish.

NextStartTime

The time at which the next downtime event will begin.  If downtime is based on the working time for an entity, then the next start time is estimated assuming that it will work continuously until the downtime event occurs.

CalculatedDowntimeRatio

The value calculated directly from model inputs for:

(avg. downtime duration)/(avg. downtime interval)

Availability

The fraction of calendar time (excluding the initialisation period) during which this type of downtime did not occur.

User-defined attributes and custom outputs

As defined by the AttributeDefinitionList and CustomOutputList inputs.