Skip to end of metadata
Go to start of metadata

The OEE Downtime 2.0 tab is specific to the OEE module and is available for the Line, Cell Group and Cell Production Items. A number of configuration settings are provided that can be used to obtain equipment mode, state and count values from ignition tags (whether PLC tags, memory or expression tags).

Downtime Detection Mode

How line downtime is determined can be changed based on the selected Downtime Detection Mode. Valid options for the downtime detection mode are...

  • Equipment State
  • Key Reason (Cell Priority)
  • Key reason (Neighbor Priority)
  • Initial Cell
  • Parallel Cells

Refer to Downtime Detection Mode for more information on the various Downtime Detection Methods.

Downtime Detection Mode is only available for the Line and Cell Group Production Item.

Minimum Cells Running Threshold

Minimum Cells Running Threshold determines how many cells in the Line (or Cell Group) must be running in order for the Line (or Cell Group) to be considered as Running.

Tag Collector Paths

Tag Collectors are provided to allow any of the parameters needed to drive OEE Metrics to be provided externally to the OEE module. Virtually all the Tag Collectors can be left blank in which case the OEE engine will determine the value from product code configuration information as defined in the OEE Material Manager or from internal calculations. Exceptions to this would be the equipment state and counts where needed.

Note

The fastest recording resolution is 1 second and the value will be overridden if a tag changes within the same second. This applies to all tag collectors except for shift.


OEE Rates are stored as "per minute"

The Sepasoft OEE module always stores rates (including the Standard Rate) in "per minute" equivalent, in order to streamline functionality (regardless of the units set in GUI-based components such as the OEE Material Manager). However, when utilizing the Tag Collector, you are storing values directly to the database, so you must convert the values to "per minute" before writing values to these tags. Rate values in the Value Editor will also be "per minute".


Tag Collector PathData TypeDescription
Mode
Integer

When left blank, the Mode will be determined from the Mode setting for the currently running Product Code (Material), as defined in the Material Manager. When a tag path is provided, the Mode for the line or equipment (cell) will be determined from the value of the tag. For more information on the Mode, refer to the Material Production Settings section.

State

IntegerThe State Tag path will generally come from a PLC as the source of the current equipment state. Exceptions to this are at the Line level when using a downtime detection method other than Equipment State.

Note

StringAs well as through scripting on the OEE Downtime Table component, the downtime notes can also be added by passing a note through a tag referenced here.

Shift

StringWhen left blank, shifts defined in the Ignition Schedule Management component and defined in the Equipment Manager for a line will be used to determine the current shift. If a tag is provided here, whatever value is in the tag e.g. 'Shift A' will be recorded for the current shift.

Product Code

StringWhen left blank, the Product Code currently running on the line will be determined from the scheduled run as selected by the Scheduler or Run Director component. When a tag path is provided, the product code for the line or equipment (cell) will be determined from the value of the tag.

Work Order

StringWhen left blank, the Work Order currently running on the line will be determined from the scheduled run as selected by the Scheduler or Run Director component. When a tag path is provided, the product code for the line or equipment (cell) will be determined from the value of the tag.

Package Count

Float

When left blank, the Package Count will be determined from the Package count setting for the currently running Product Code (Material) as defined in the Material Manager. When a tag path is provided, the Package Count for the line or equipment (cell) will be determined from the value of the tag. For more information on the Package Count, refer to the Material Production Settings section.

Outfeed Units

String

When left blank, the Line Outfeed Units will be determined from the Line Outfeed Units setting for the currently running Product Code (Material) as defined in the Material Manager. When a tag path is provided, the Line Outfeed Units for the line or equipment (cell) will be determined from the value of the tag. For more information on the Line Outfeed Units, refer to the Material Production Settings section.

Infeed Count Scale

Float

When left blank, the Infeed Count Scale will be determined from the Infeed Count Scale setting for the currently running Product Code (Material) as defined in the Material Manager. When a tag path is provided, the Infeed Count Scale for the line or equipment (cell) will be determined from the value of the tag. For more information on the Infeed Count Scale, refer to the Material Production Settings section.

Infeed Units

String

When left blank, the Line Infeed Count Scale will be determined from the Infeed Count Scale setting for the currently running Product Code (Material) as defined in the Material Manager. When a tag path is provided, the Infeed Count Scale for the line or equipment (cell) will be determined from the value of the tag. For more information on the Line Infeed Units, refer to the Material Production Settings section.

Reject Count Scale

Float

When left blank, the Reject Count Scale will be determined from the Reject Count Scale setting for the currently running Product Code (Material) as defined in the Material Manager. When a tag path is provided, the Reject Count Scale for the line or equipment (cell) will be determined from the value of the tag. For more information on the Reject Count Scale, refer to the Material Production Settings section.

Reject UnitsString

When left blank, the Line Reject Units will be determined from the Line Reject Units setting for the currently running Product Code (Material) as defined in the Material Manager. When a tag path is provided, the Line Reject Units for the line or equipment (cell) will be determined from the value of the tag. For more information on the Line Reject Units, refer to the Material Production Settings section.

Standard RateFloat

When left blank, the Standard Rate will be determined from the Standard Rate setting for the currently running Product Code (Material) as defined in the Material Manager. When a tag path is provided, the Standard Rate for the line or equipment (cell) will be determined from the value of the tag. For more information on the Standard Rate, refer to the Material Production Settings section.

Schedule RateFloat

When left blank, the Schedule Rate will be determined from the Schedule Rate setting for the currently running Product Code (Material) as defined in the Material Manager. When a tag path is provided, the Schedule Rate for the line will be determined from the value of the tag. For more information on the Schedule Rate, refer to the Material Production Settings section.

Schedule Rate Tag Path is only available for the Line Production Item.
Schedule CountInteger

When left blank, the Schedule Count will be determined from the scheduled run as selected by the Scheduler or Run Director component. When a tag path is provided, the Schedule Count for the line or equipment (cell) will be determined from the value of the tag. The Schedule Count provides the number of units scheduled to be produced.

Schedule Count Tag Path is only available for the Line Production Item.

Schedule DurationInteger

When left blank, the Schedule Duration will be determined from the scheduled run as selected by the Scheduler or Run Director component. When a tag path is provided, the Schedule Duration for the line or equipment (cell) will be determined from the value of the tag. The Schedule Duration provides the expected runtime required for the number of units scheduled to be produced and is calculated by the Schedule Rate.

Rate PeriodString

When left blank, the Rate Period will be determined from the Rate Period setting for the currently running Product Code (Material) as defined in the Material Manager. When a tag path is provided, the Rate Period for the line or equipment (cell) will be determined from the value of the tag. For more information on the Rate Period, refer to the Material Production Settings section.

Target C/O TimeInteger

When left blank, the Target C/O (Changeover) Time will be determined from the Changeover settings for the currently running Product Code (Material) as defined in the Material Manager. When a tag path is provided, the Target C/O (Changeover) Time for the line or equipment (cell) will be determined from the value of the tag. For more information on the Target C/O (Changeover) Time, refer to the Material Production Settings section.

Target C/O Time  Tag Path is only available for the Line Production Item.

Cycle CountFloatWhen left blank, the Cycle Time metrics will not be calculated. When a tag path is provided, the Cycle Count for the line or equipment (cell) will be determined from the value of the tag and Cycle Time metrics will be calculated as a result.
Operation UUIDString

When left blank, the Operation UUID will be determined from the currently running Operation on the Line or equipment (cell). When a tag path is provided, the Operation UUID for the line or equipment (cell) can be determined from the value of the tag. The purpose for this tag is to be able to provide OEE analysis data when production runs are not scheduled or started using the Run Director or Schedule Selector components, or scripting functions. In this case a tag can be used to provide a Run Identifier value i.e. Run_4253_XX. The Analysis Selector provides the ability to pull the Operation UUID as part of analysis, whether it is an internally generated Operation UUID or a passed Run Identifier.

You must provide a value for Operation UUID for analysis to calculate OEE if you are not starting an OEE operation.


Tag Collector Paths can be parameterized with {Equipment Path} to utilize indirection and more rapidly implement the production model. See Parameterized Tag Paths for more details.



Live Analysis

Live Analysis provides a flexible way of customizing your application to provide a set of real-time tag values that can be accessed from the Ignition Designer and used in your application to provide real-time production monitoring. Live Analysis is configured in the OEE 2.0 Downtime tab of the Production Model Designer for the Line, Cell Group and Cell production items. When a Live Analysis is created, a corresponding set of tags is created in the MES Tag Provider that provide the real-time status of those datapoints based upon the Period defined for the Live Analysis. You can create multiple Live Analysis and use those tags to drive HMI displays.

To create a new Live Analysis:

  • Right click on the Live Analysis panel on the OEE 2.0 Downtime Tab in the Production Model Designer.
  • Provide a Name
  • Select the Period that the Live Analysis datapoints will return a value for. Valid options are Shift, Day (Midnight), Day (Production), Start of Run, Top of Hour, Custom Period Tag

     If a production run is not active, changed "Start of Run" mode of Live Analysis will show last production run values.

  • Select the frequency for how often the tag values will be updated. Default value is 60 seconds. Minimum value is 60 seconds
  • Select the desired Data Points
  • Add any further Settings Values required

You cannot select all Data Points in one Live Analysis. The maximum length string for Data Points is 1024 characters

Live Analysis Settings Panel in the OEE 2.0 Downtime Tab

Watch the Video


MES Tag Provider Live Analysis Tags





Live Analysis Settings

SettingDescription

Analysis Name

The name for the live analysis

Naming Characters Allowed

Names must begin with a letter, digit or underscore. Subsequent characters may also include spaces and dashes. The following characters are not allowed in any MES Object Name:
. ? ! # % ^ * ~ [ ] { } + = ` \
Also not allowed for Production Equipment Names:
, @ & ( ) < >
Also not allowed for MES Person Objects:
/ " $ | < >
Also not allowed for other MES Objects:
/ " $ | ,

Enabled

The live analysis can be enabled or disabled with this setting

Period

The duration of analysis can be set by:

  • Shift - The schedules that are defined with Ignition's Schedule Management component will be used to determine the duration of analysis.
  • Day (midnight) - This duration starts from 12 AM.
  • Day (production) - This starts from the day's first shift.
  • Start of Run - The duration of analysis begins when the operation start running.
  • Top of Hour - This is the beginning of the hour. So if the analysis is run at 6:45 PM, it will cover from 6:00 PM to 6:45 PM.
  • Custom Period Tag - A tag is set to control the analysis duration.

Custom Period Tag

A tag can be assigned to define the start datetime for a custom period. The end time will be the current time. It takes value in the date time data type. Example for a valid value for the custom period tag is: 2017/04/04 14:00:00

If your Custom Period Tag changes regularly (e.g. every minute or similar), you should place Disable Live Cache=True into the Settings Values field. This will prevent new cache files from being generated every time the tag changes, but will also mean that it won't use the caching functionality built into Live Analysis.

Update Rate

The rate in seconds by which the live analysis is updated. The minimum update rate is 60 seconds
Data PointsData points allows you to pick and choose the values you wish to access through tags. See the table below for the listing of available data points
Optional Filter

The optional filter has the same rules as the analysis selector filter but it must not contain any of the following since live analysis is already filtered to an equipment:

  • Equipment Path
  • Equipment Name
  • Equipment Type
  • Equipment Cell Order
  • Is Key Cell
Setting ValuesVarious filters and qualifiers are available to refine live analysis results. Refer to the Setting Values section at the bottom of this page for details.





Shift Data Points

When creating a Live Analysis, the following shift data points will be automatically created.

Data PointData TypeDescription
AvailablebooleanTrue if the line is currently within an available period.
Available Begin DateDateTimeIf in an available time, this is the time that that availability began. If in an unavailable time, it reflects the begin date of the most recent availability period.
Available End DateDateTimeIf in an available time, this is the time that that availability ended. If in an unavailable time, it reflects the ending date of the most recent availability period.
Current ShiftStringThe currently running shift as defined in the Ignition Schedule Management component or passed from the Shift Tag Collector path.
Production Day Begin DateDateTime

Start time of the production day's first shift.

Example:
Shift 1: Monday 6AM to Monday 2PM
Shift 2: Monday 2PM to Monday 10PM
Shift 3: Monday 10PM to Tuesday 6AM
If it is currently Tuesday at 4AM, then Production Day Begin Date is Monday 6AM, since that is when the first shift of the production day began (Shift 3 is still part of Monday's 3-shift production day).

Shift Begin DateDateTimeStart time of the Current Shift (the time the Current Shift tag first changed to a given value).
Shift End DateDateTimeEnding time of the Current Shift.








Analysis Data Points and Settings are used by Live Analysis, the MES Analysis Selector and MES Analysis Controller components, the MES Analysis Data Source for reporting and the MES Analysis Settings object.

Watch the Video




Duration values in Float8 or Double

Duration values of data type Float8 or Double are in minutes plus fractions of minutes (not seconds).
Example: 5.40 = 5 minutes and 24 seconds (because 0.40 = 24sec/60sec)

Equipment Data Points

Data PointData TypeDescriptionUnits
Equipment

Equipment Cell Order

Int4Integer value that determines the cell order of the equipment within the line. Is set to null for the line. Is set to 0 for first cell within each cell group.N/A

Equipment Name

StringName of the equipment as defined in the production model.N/A
Equipment NoteStringAny note that has been recorded for this piece of equipment through the Note tag collector path in the Production model will be exposed here.N/A
Equipment Operation BeginDateTimeStart Date Time of the currently running operation on this equipment.N/A
Equipment Operation EndDateTimeEnd DateTime of the last operation that ran on this equipment.N/A
Equipment Operation Original BeginDateTimeThe original user-set begin DateTime for the operation on this equipment. This value does not change if the operation schedule changes.N/A
Equipment Operation Original EndDateTimeThe original user-set end DateTime for the operation on this equipment. This value does not change if the operation schedule changes.N/A
Equipment Operation Scheduled BeginDateTimeThe current system-set begin DateTime for the operation on this equipment. Value will remain as null if the operation was not created via a schedule.N/A
Equipment Operation Scheduled EndDateTimeThe current system-set end DateTime for the operation on this equipment. Value will remain as null if the operation was not created via a schedule.N/A

Equipment Operation Sequence

Int4The ordinal number (integer) of operation.N/A

Equipment Path

StringProduction model path for this equipment.N/A

Equipment Type

StringCan be Line, Cell Group or Cell.N/A
Execution Time (ms)Int8Time taken to execute and update the Live Analysis. Used mainly for performance debugging. 
Note: This Data Point is not selectable in the MES Analysis Selector component.
milliseconds

Infeed Units

StringSee Infeed Units for more details.This could be Cans, Bottles, etc.

Is Key Cell

BooleanSee Key Reason for more details.N/A

Operation UUID

StringUnique Identifier for currently running operation.N/A

Outfeed Units

StringSee Outfeed Units for more details.This could be Cans, Bottles, etc.

Product Code

StringProduct code currently being processed on this equipment.N/A

Rate Period

StringSee Rate Period for more details.Options: Hours or Minutes

Reject Units

StringSee Reject Units for more details.This could be Cans, Bottles, etc.

Work Order

StringWork order currently being processed on this equipment.N/A





Equipment Count Data Points

Data PointData TypeDescriptionUnits
Equipment/Count*Any defined counters for the production item will also appear in this folder

Equipment Infeed Scale

Float8See Infeed Count Scale for more details.N/A

Equipment Package Count

Float8See Package Count for more details.N/A

Equipment Reject Scale

Float8See Reject Count Scale for more details.N/A
<counter_kind>-<counter_name>IntegerThere will be one Data Point generated for each MES Counter created in the Production Model (General tab, MES Counters section). Each will be named as the Counter Kind (General, Infeed, Outfeed or Reject), followed by a dash and then the Counter Name provided. Example: Outfeed-Material Out.
The hover tooltip seen in the MES Analysis Selector component will be the text in the Counter Description field for the counter.
N/A



Equipment Cycle Time Data Points

The Cycle Time data points provide a number of metrics that can be used to measure the amount of time required to produce one piece. It is often used to gain an understanding of variations in production. The Cycle Time calculations are based on the Cycle Count value provided to the system.  Analysis provides Target, Normal, Overall, and Precise Cycle Time metrics.  The Analysis Engine assumes valid data for this calculation.  Invalid data, such as Unknown States, disrupt the calculation.  Details of the calculations are described below.


Included in AnalysisNot Included in Analysis

States Analyzed Per Cycle Metric

Cycle Time Metric

Running

Unplanned Downtime

Planned Downtime

Starved

Blocked

Idle

Disabled

Overall Cycle Time








Normal Cycle Time








Precise Cycle Time









 Cycle Time In Detail...

Cycle Time Calculations

There are 3 different representations of cycle time that are available to users when using Analysis. Each filters run state date differently.

Overall Cycle Time Calculations

Overall Cycle Time

Overall Cycle time is defined as including all time in which the equipment is in any state except a disabled state.

overallCycleTime = analysisRowTime - disabledTime

Maximum Overall Cycle Time

Maximum Overall Cycle Time is defined as the cycle with the largest overall time in the scope of the analysis row.

Look at each of the cycles time periods, subtract any time the equipment was in a disabled state, then select the largest value.

Minimum Overall Cycle Time

Minimum Overall Cycle Time is defined as the cycle with the smallest overall time in the scope of the analysis row.

Look at each of the cycles time periods, subtract any time the equipment was in a disabled state, then select the smallest value.

Average Overall Cycle Time

Average Overall Cycle Time is defined as the average overall time per completed cycle in the scope of the analysis row.

averageOverallCycleTime = overallCycleTime / numberOfCompletedCycles



Normal Cycle Time Calculations

Normal Cycle Time

Normal Cycle time is defined as including all time in which the equipment is in any state except for disabled, idle, planned downtime, blocked, or starved.

normalCycleTime = analysisRowTime - (disabledTime + blockedTime + starvedTime)

Maximum Normal Cycle Time

Maximum Normal Cycle Time is defined as the cycle with the largest normal time in the scope of the analysis row.

Look at each of the cycles time periods, subtract any time the equipment was in a disabled, idle, planned downtime, blocked, or starved state, then select the largest value.

Minimum Normal Cycle Time

Minimum Normal Cycle Time is defined as the cycle with the smallest normal time in the scope of the analysis row.

Look at each of the cycles time periods, subtract any time the equipment was in a disabled, idle, planned downtime, blocked, or starved state, then select the smallest value.

Average Overall Cycle Time

Average Normal Cycle Time is defined as the average normal time per completed cycle in the scope of the analysis row.

averageNormalCycleTime = normalCycleTime / numberOfCompletedCycles



Precise Cycle Time Calculations

Precise Cycle Time

Precise Cycle time is defined as including all time in which the equipment is in the running state only.

preciseCycleTime=analysisTime-(anyTimeNotRunning)

Maximum Precise Cycle Time

Maximum Precise Cycle Time is defined as the cycle with the largest precise time in the scope of the analysis row.

Look at each of the cycles time periods, subtract any time the equipment was not in a running state, then select the largest value.

Minimum Precise Cycle Time

Minimum Precise Cycle Time is defined as the cycle with the smallest precise time in the scope of the analysis row.

Look at each of the cycles time periods, subtract any time the equipment was not in a running state, then select the smallest value.

Average Precise Cycle Time

Average Precise Cycle Time is defined as the average precise time per completed cycle in the scope of the analysis row.

averagePreciseCycleTime = preciseCycleTime / numberOfCompletedCycles



Example:

The diagram below represents an analysis sample looking at a scope of 50 minutes. Each sample varies in complexity of calculation of cycle time and counts.



Important Things to Note

  • Each Time Tick represents 1 minute.

  • The scope of each Analysis Row (delimited by Analysis Endpoints) is 10 minutes.

  • Each part takes 2 minutes of Production Time to make.

  • Minimum, Maximum, and Average Cycle Time calculations only look at the completed (whole) cycles within the analysis rows. Cycle times can span previous rows. Example: If an Analysis result set spans from 3:00PM to 5:00PM, but the first increment to the Cycle Count occurs at 3:05PM, then that initial 5 minutes is not included when calculating the Min, Max or Average data points for Cycles. Likewise, any incomplete cycles at the end of the date range will also not be included in the calculations.



Calculation Complexity Definitions

Complexity

Description

Low

Very simple to calculate all different cycle times. (Overall, Normal, and Precise the same)

Medium

A little more difficult to calculate different cycle times. (At least 2 types have different results.) May have cycles extending past the analysis scope.

High

The most difficult to calculate different cycle times. (All types have different results.) Has cycles extending past the analysis scope.



 Sample 1 (High Complexity)


Sample 1 (High Complexity)

Cycle Time Length

Type

Time Calculation

Value

Overall Cycle Time

tanalysis

10 minutes

Normal Cycle Time

tanalysis - t2

9 minutes

Precise Cycle Time

tanalysis - (t2 + t6)

7 minutes

Min Cycle Time (note)

Type

Cycle Time Calculation

Min Cycle Time (mins)


Min Overall Cycle Time

C1overall: t0 = 2 mins

C2overall: t1+t2+t3 = 3 mins

C3overall: t4 = 2 mins


2 minutes


Min Normal Cycle Time

C1normal: t0 = 2 mins

C2normal: t1+t3 = 2 mins

C3normal: t4 = 2 mins


2 minutes


Min Precise Cycle Time

C1precise: t0 = 2 mins

C2precise: t1+t3 = 2 mins

C3precise: t4 = 2 mins


2 minutes

Max Cycle Time (note)

Type

Cycle Time Calculation

Max Cycle Time (mins)

Max Overall Cycle Time

Same as Min Cycle Time

3 minutes

Max Normal Cycle Time

Same as Min Cycle Time

2 minutes

Max Precise Cycle Time

Same as Min Cycle Time

2 minutes

Average Cycle Time (note)

Type

Avg Time Calculation

Avg Value

Average Overall Cycle Time

(C1overall + C2overall + C3overall) / 3 cycles

(2 mins + 3 mins +2 mins) / 3 cycles

2.33 minutes

Average Normal Cycle Time

(C1normal + C2normal + C3normal) / 3 cycles

(2 mins + 2 mins + 2 mins) / 3 cycles

2.00 minutes

Average Precise Cycle Time

(C1precise + C2precise + C3precise) / 3 cycles

(2 mins + 2 mins + 2 mins) / 3 cycles

2.00 minutes



 Sample 2 (Medium Complexity)


Sample 2 (Medium Complexity)

Type

Time Calculation

Value

Overall Cycle Time

tanalysis

10 minutes

Normal Cycle Time

tanalysis

10 minutes

Precise Cycle Time

tanalysis - t9

6 minutes

Min Cycle Time (note)

Type

Cycle Time Calculation

Min Cycle Time (mins)


Min Overall Cycle Time

C4overall: t7+t8+t9+t10 = 8 mins

C5overall: t11 = 2 mins

C6overall: t12 = 2 mins


2 minutes


Min Normal Cycle Time

C4normal: t7+t8+t9+t10 = 8 mins

C5normal: t11 = 2 mins

C6normal: t12 = 2 mins


2 minutes


Min Precise Cycle Time

C4precise: t7+t10 = 2 mins

C5precise: t11 = 2 mins

C6precise: t12 = 2 mins


2 minutes

Max Cycle Time (note)

Type

Cycle Time Calculation

Max Cycle Time (mins)

Max Overall Cycle Time

Same as Min Cycle Time

8 minutes

Max Normal Cycle Time

Same as Min Cycle Time

8 minutes

Max Precise Cycle Time

Same as Min Cycle Time

2 minutes

Average Cycle Time (note)

Type

Avg Time Calculation

Avg Value

Average Overall Cycle Time

(C4overall + C5overall + C6overall) / 3 cycles

(8 mins + 2 mins +2 mins) / 3 cycles

4.00 minutes

Average Normal Cycle Time

(C4normal + C5normal + C6normal) / 3 cycles

(8 mins + 2 mins + 2 mins) / 3 cycles

4.00 minutes

Average Precise Cycle Time

(C4precise + C5precise + C6precise) / 3 cycles

(2 mins + 2 mins + 2 mins) / 3 cycles

2.00 minutes



 Sample 3 (Medium Complexity)


Sample 3 (Medium Complexity)

Cycle Time Length

Type

Time Calculation

Value

Overall Cycle Time

tanalysis

10 minutes

Normal Cycle Time

tanalysis - t20

9 minutes

Precise Cycle Time

tanalysis - t20

9 minutes

Min Cycle Time (note)

Type

Cycle Time Calculation

Min Cycle Time (mins)



Min Overall Cycle Time

C7overall: t14+t15 = 2 mins

C8overall: t16 = 2 mins

C9overall: t17 = 2 mins

C10overall: t18 = 2 mins

C11overall: t19 = 2 mins



2 minutes



Min Normal Cycle Time

C7normal: t14+t15 = 2 mins

C8normal: t16 = 2 mins

C9normal: t17 = 2 mins

C10normal: t18 = 2 mins

C11normal: t19 = 2 mins



2 minutes



Min Precise Cycle Time

C7precise: t14+t15 = 2 mins

C8precise: t16 = 2 mins

C9precise: t17 = 2 mins

C10precise: t18 = 2 mins

C11precise: t19 = 2 mins



2 minutes

Max Cycle Time (note)

Type

Cycle Time Calculation

Max Cycle Time (mins)

Max Overall Cycle Time

Same as Min Cycle Time

2 minutes

Max Normal Cycle Time

Same as Min Cycle Time

2 minutes

Max Precise Cycle Time

Same as Min Cycle Time

2 minutes

Average Cycle Time (note)

Type

Avg Time Calculation

Avg Value

Average Overall Cycle Time

(C7overall + C8overall + C9overall + C10overall + C11overall)/ 5 cycles

(2 mins + 2 mins + 2 mins + 2 mins +2 mins) / 5 cycles

2.00 minutes

Average Normal Cycle Time

(C7normal + C8normal + C9normal + C10normal + C11normal)/ 5 cycles

(2 mins + 2 mins + 2 mins + 2 mins +2 mins) / 5 cycles

2.00 minutes

Average Precise Cycle Time

(C7precise + C8precise + C9precise + C10precise + C11precise)/ 5 cycles

(2 mins + 2 mins + 2 mins + 2 mins +2 mins) / 5 cycles

2.00 minutes



 Sample 4 (Medium Complexity)


Sample 4 (Medium Complexity)

Cycle Time Length

Type

Time Calculation

Value

Overall Cycle Time

tanalysis

10 minutes

Normal Cycle Time

tanalysis - t22

6 minutes

Precise Cycle Time

tanalysis - t22

6 minutes

Min Cycle Time (note)

Type

Cycle Time Calculation

Min Cycle Time (mins)


Min Overall Cycle Time

C12overall: t21+t22+t23 = 7 mins

C13overall: t24 = 2 mins

C14overall: t25 = 2 mins


2 minutes


Min Normal Cycle Time

C12normal: t23 = 2 mins

C13normal: t24 = 2 mins

C14normal: t25 = 2 mins


2 minutes


Min Precise Cycle Time

C12precise: t23 = 2 mins

C13precise: t24 = 2 mins

C14precise: t25 = 2 mins


2 minutes

Max Cycle Time (note)

Type

Cycle Time Calculation

Min Cycle Time (mins)

Max Overall Cycle Time

Same as Min Cycle Time

7 minutes

Max Normal Cycle Time

Same as Min Cycle Time

2 minutes

Max Precise Cycle Time

Same as Min Cycle Time

2 minutes

Average Cycle Time (note)

Type

Avg Time Calculation

Avg Value

Average Overall Cycle Time

(C12overall + C13overall + C14overall)/ 3 cycles

(7 mins + 2 mins + 2 mins) / 3 cycles

3.67 minutes

Average Normal Cycle Time

(C12normal + C13normal + C14normal)/ 3 cycles

(2 mins + 2 mins + 2 mins) / 3 cycles

2.00 minutes

Average Precise Cycle Time

(C12precise + C13precise + C14precise)/ 3 cycles

(2 mins + 2 mins + 2 mins) / 3 cycles

2.00 minutes



 Sample 5 (Low Complexity)


Sample 5 (Low Complexity)

Cycle Time Length

Type

Time Calculation

Value

Overall Cycle Time

tanalysis

10 minutes

Normal Cycle Time

tanalysis

10 minutes

Precise Cycle Time

tanalysis

10 minutes

Min Cycle Time (note)

Type

Cycle Time Calculation

Min Cycle Time (mins)



Min Overall Cycle Time

C15overall: t26 = 2 mins

C16overall: t27 = 2 mins

C17overall: t28 = 2 mins

C18overall: t29 = 2 mins

C19overall: t30 = 2 mins



2 minutes



Min Normal Cycle Time

C15normal: t26 = 2 mins

C16normal: t27 = 2 mins

C17normal: t28 = 2 mins

C18normal: t29 = 2 mins

C19normal: t30 = 2 mins



2 minutes



Min Precise Cycle Time

C15precise: t26 = 2 mins

C16precise: t27 = 2 mins

C17precise: t28 = 2 mins

C18precise: t29 = 2 mins

C19precise: t30 = 2 mins



2 minutes

Max Cycle Time (note)

Type

Cycle Time Calculation

Min Cycle Time (mins)

Max Overall Cycle Time

Same as Min Cycle Time

2 minutes

Max Normal Cycle Time

Same as Min Cycle Time

2 minutes

Max Precise Cycle Time

Same as Min Cycle Time

2 minutes

Average Cycle Time (note)

Type

Avg Time Calculation

Avg Value

Average Overall Cycle Time

(C15overall + C16overall + C17overall + C18overall + C19overall)/ 5 cycles

(2 mins + 2 mins + 2 mins + 2 mins +2 mins) / 5 cycles

2.00 minutes

Average Normal Cycle Time

(C15normal + C16normal + C17normal + C18normal + C19normal)/ 5 cycles

(2 mins + 2 mins + 2 mins + 2 mins +2 mins) / 5 cycles

2.00 minutes

Average Precise Cycle Time

(C15precise + C16precise + C17precise + C18precise + C19precise)/ 5 cycles

(2 mins + 2 mins + 2 mins + 2 mins +2 mins) / 5 cycles

2.00 minutes





Data PointData TypeDescriptionUnits
Equipment/Cycle Time

Relative Cycle Count

String

Relative Cycle Count is the change in cycle count that occurred during an analysis row.

The scope of this is comparing the difference between the current and previous row.
N/A

Target Cycle Time

Float8Also known as Takt time, it is how often a piece must be produced to meet customer demand. It is often used to pace a production line, and it is a calculated number in minutes. This is defined a 1/Standard Rate.minutes
Total Cycle CountString

Total Cycle Count is cumulative and represents the total change in cycle count since the beginning of the analysis period.

This value persists across rows. For example, you have had 10 cycles so far. You have another 5 cycles in the next period. The analysis row will read 15 cycles and continue to be a summation.
N/A

Equipment/Cycle Time/Normal

Normal Cycle Time calculations include Running and Unplanned Downtime states and ignore all other states like Starved, Blocked, Planned Downtime etc.

Average Normal Cycle Time

Float8Average Normal cycle time in minutes.minutes

Max Normal Cycle Time

Float8Max Normal cycle time in minutes.minutes

Min Normal Cycle Time

Float8Min Normal cycle time in minutes.minutes

Normal Cycle Time

Float8Time spent cycling that includes Running and Unplanned Downtime states and ignores all other equipment states.minutes

Equipment/Cycle Time/Overall

Overall Cycle Time calculations include all equipment states except Disabled.

Average Overall Cycle Time

Float8Average Overall cycle time in minutes.minutes

Max Overall Cycle Time

Float8Max Overall cycle time in minutes.minutes

Min Overall  Cycle Time

Float8Min Overall cycle time in minutes.minutes

Overall Cycle Time

Float8Time spent cycling that includes all equipment states except Disabled.minutes

Equipment/Cycle Time/Precise

Precise Cycle Time calculations only include equipment Running states.

Average Precise Cycle Time

Float8Average Precise cycle time in minutes.minutes

Max Precise  Cycle Time

Float8Max Precise cycle time in minutes.minutes

Min Precise Cycle Time

Float8Min Precise cycle time in minutes.minutes

Precise Cycle Time

Float8Time spent cycling that only includes equipment Running states.minutes



Line Data Points

The Line Data points returns data for the line regardless of the Equipment the Live Analysis has been set up for.

Data PointData TypeDescriptionUnits
Equipment/Line/Downtime

Line Downtime Can Revert Split

BooleanTrue if the line downtime reason split can be reverted.N/A

Line Downtime End State Time Stamp

DateTimeWhen down time events are rolled up, this is the time stamp of the last event.N/A

Line Downtime Equipment Name

StringName of the equipment that is responsible for causing line downtime.N/A

Line Downtime Equipment Path

StringProduction model equipment path for equipment that is responsible for causing line downtime.N/A

Line Downtime Event Sequence

Int4Every downtime event on the line is provided with an incrementing sequence number.N/A

Line Downtime Occurrence Count

Int4Number of downtime events for the selected period.N/A

Line Downtime Original Equipment Path

StringThe original path of the equipment that caused the line downtime before being reassigned to differed equipment.N/A

Line Downtime Original Reason

StringThe line or cell group (sub line) original downtime reason.N/A

Line Downtime Original Reason Code

Int4The line or cell group (sub line) original downtime reason code.N/A

Line Downtime Reason

String

The line or cell group (sub line) downtime reason.

  1. When the line is down the Line Downtime Reason is the same as the Line State Name.
  2. When the line is up the Line Downtime Reason is blank.
N/A

Line Downtime Reason Path

StringThe reason name for line or cell group (sub line) downtime reasons, including Equipment State Class and any reasons above the selected reason in the state tree. E.g. Default Class/Unplanned Downtime/Mechanical Faults/Chain Slip.N/A

Line Downtime Reason Split

BooleanThe line downtime reason split indicator. True is current downtime event has been split into multiple downtime events.N/A

Line Downtime State Time Stamp

DateTimeThe time stamp for the equipment state change of the cell group (sub line) or cell that caused the line downtime events.N/A
Equipment/Line/Meantime
Line MTBFFloat8

The calculated Meantime (minutes) Between Failure for the line (or subline) in the selected period and does take into account the downtime detection method.

Refer to Setting Up Equipment States - Meantime Metrics for more details.

minutes
Line Meantime Metrics EnabledBooleanReturns true if the current line (or subline) state is enabled for meantime metrics.N/A
Equipment/Line/Schedule

Line Schedule Available

BooleanTrue if this operation was scheduled.N/A

Line Schedule Available Time

Float8Time in minutes for available production time adjusted for line schedule availability and mode. "Line Schedule Available Time" is not applicable to cells or cell groups.minutes

Line Standard Count

StringAmount of product that should have been produced based on the line schedule available time and line standard rate. The available time is determined from the Ignition schedules that are selected for the line. If Ignition schedules are not selected for the line, then the scheduled count will be used. Actual line downtime is not used for this calculation.N/A
Line Schedule CountDoubleScheduled count of a machine.N/A
Line Schedule DurationDoubleScheduled duration of a machine.minutes

Line Standard Count Variance

StringVariance between line standard count and line OEE outfeed count.N/A

Line Target Count

StringAmount of product that should have been produced based on the line schedule available time and line schedule rate. The available time is determined from the Ignition schedules that are selected for the line. If Ignition schedules are not selected for the line, then the scheduled count will be used. Actual line downtime is not used for this calculation.N/A

Line Target Count Variance

StringVariance between line scheduled count and line OEE outfeed count.N/A

Schedule Rate

Float8See Schedule Rate for more details.production units/unit of time
Scheduled ShiftStringScheduled shift, based on the assigned Ignition schedule.N/A
Scheduled Shift End Date TimeDateTimeScheduled end date, based on the assigned Ignition schedule.N/A
Scheduled Shift Start Date TimeDateTimeScheduled start date, based on the assigned Ignition schedule.N/A
Equipment/Line/State

Line State Duration

Float8

The line or cell group (sub line) downtime event duration in minutes.

Important

Line state event duration will respect the group by for the analysis query. This means that the line state duration will be constrained to be within the time slice represented by the row, even if the line state event begin time is before the from time for the row or the line state event end time is after the to time for the row.

minutes

Line State Event Begin

DateTime

The line or cell group (sub line) downtime event begin date time.

Note

For Line State Event Begin Time and Line State Event End Time the times displayed will always be the actual begin and end times, even if the times fall outside of the row to and from times.

N/A

Line State Event End

DateTime

The line or cell group (sub line) downtime event end date time.

Note

For Line State Event Begin Time and Line State Event End Time the times displayed will always be the actual begin and end times, even if the times fall outside of the row to and from times.

N/A

Line State Event Sequence

Int4The equipment state event sequence number.N/A

Line State Name

String

The line or cell group (sub line) state.

  1. When the line is down the Line Downtime Reason is the same as the state name.
  2. When the line is up the Line Downtime Reason is blank.
  3. The Line State Name may differ from the Equipment State Name for the equipment item based on the Downtime Detection Mode.
    1. E.g. Line State Tag indicates a state, but Key Reason (Cell Priority) Downtime Detection Mode overrides local Equipment State such that the Line State reflects the Key Cell State.
N/A
Line State OverriddenBooleanOverriding line downtime reasons happen at the line level. The reason for this has to do with equipment can be changed which would require several cell state to be changed to work correctly when key reason detection and / or cell groups are used. If the line state has been overridden, then it will be true.N/A

Line State Override Scope

StringThe state override scope for a line or cell group (sub line). See Setting Up Equipment - Override Scope for more details.N/A

Line State Override Type

StringThe state override type for a line or cell group (sub line). See Setting Up Equipment - Override for more details.N/A

Line State Type

StringThe line or cell group (sub line) state type. See Setting Up Equipment - State Type for more details.N/A

Line State Value

Int4The line or cell group (sub line) downtime state code. See Setting Up Equipment - State Code for more details.N/A



Equipment Mode & State Data Points

Data PointData TypeDescriptionUnits
Equipment/Mode

Equipment Mode Name

StringName of the current mode. See Equipment Modes for more details.N/A

Equipment Mode Type

StringName of the current mode type. See Equipment Modes for more details.N/A

Equipment Mode Value

Int4Name of the current mode. See Equipment Modes for more details.N/A

Mode Begin Time

DateTime

Start time of the current mode.

Note

For Mode Begin Time and Mode End Time the times displayed will always be the actual begin and end times, even if the times fall outside of the row to and from times.

N/A

Mode Duration

Float8Duration of the current mode in minutes. This is calculated as Mode End Time - Mode Begin Time.minutes
Mode End TimeDateTime

End time of the current mode.

Note

For Mode Begin Time and Mode End Time the times displayed will always be the actual begin and end times, even if the times fall outside of the row to and from times.

N/A
OEE EnabledBooleanSee Setting Up Equipment Modes - OEE Enabled for more details.N/A
Production Counts EnabledBooleanSee Setting Up Equipment Modes - Production Counts Enabled  for more details.N/A
Equipment/State
Equipment Original State ValueInt4The original value of equipment state tag collector before it is updated by using MES Value Editor component or scripting.N/A
Equipment State NameString

Current state name based on tag value provided to this tag collector.

Line Level Considerations

If this is a Line production item, the Equipment State Name and Equipment State Type will hold the value of any tag provided at the line level and may differ from the Line State Name value when the Downtime Detection Mode is set to anything other than 'Equipment State'.


N/A
Equipment State PathStringThe state name and address for the given status, including Equipment State Class and any states above the selected state in the state tree. E.g. Default Class/Unplanned Downtime/Mechanical Faults/Chain Slip.N/A
Equipment State SplitBooleanTrue is current downtime event has been split into multiple downtime events.N/A
Equipment State TypeStringSee Setting Up Equipment - State Type for more details.N/A
State Begin TimeDateTime

Start time of the current state.

Note

For State Begin Time and State End Time the times displayed will always be the actual begin and end times, even if the times fall outside of the row to and from times.

N/A
State DurationFloat8Duration of current state in minutes. This is calculated as State End Time - State Begin Time.minutes
State End TimeDateTime

End time of the current state.

Note

For State Begin Time and State End Time the times displayed will always be the actual begin and end times, even if the times fall outside of the row to and from times.

N/A



Note

For Mode Begin Time and Mode End Time the times displayed will always be the actual begin and end times, even if the times fall outside of the row to and from times.



Equipment Meantime Data Points

Data PointData TypeDescriptionUnits
Equipment/Meantime
Equipment MTBFFloat8The Mean Time (minutes) Between Failure for the equipment in selected period. This does take into account the downtime detection method. minutes
Equipment Meantime Metrics EnabledBooleanTrue if Equipment Meantime Metrics are enabled for the current equipment state.N/A



General Data Points

Data PointData TypeDescriptionUnits
General
Delta Time StampFloat8Time gap (minutes) between the rows of data (measured between From Time Stamp and To Time Stamp).minutes
From Time StampDateTimeStart time (minutes) of the current period (run time of the analysis).minutes
ShiftStringName of the current shift as set by the Ignition Schedule Management component and defined for the current line or by the value passed in the equipment shift tag collector.N/A
Shift Day TextStringName of the current day.N/A
Shift Day of MonthInt4Int value of the current day of the month.N/A
Shift Day of WeekInt4Int value of the current day of the week.N/A
Shift Day of YearInt4Int value of the current day of the year.N/A
Shift ISO Week of YearInt4Int value of the ISO week of the year.N/A
Shift Month TextStringName of the current month.N/A
Shift Month of YearInt4Int value of the current month of the year. Months are numbered 0-11. (i.e January: 0, February: 1, ..., December: 11) N/A
Shift Start DateDateTimeStart date of the current shift.  Since this is a Java DateTime object, it will show midnight as the time.  Only the date is accurate.N/A
Shift Start Date TimeDateTimeStart date time of the current shift. Both the date and the time will be accurate.N/A
Shift Week of MonthInt4Int value of the current week of the month.N/A
Shift Week of YearInt4Int value of the current week of the year.N/A
Shift YearInt4Int value of the current year.N/A
To Time StampDateTimeEnd time (minutes) of the current period (run time of the analysis).minutes
General/Time


Thirty Minute Interval DateThe time for every thirty minutes starting at the analysis begin date.N/A
Fifteen Minute Interval DateThe time for every fifteen minutes starting at the analysis begin date.N/A
Top of Hour Interval DateThe time for every hour starting at the top of the hour (minutes and seconds equals 0).N/A
Hour Interval DateThe time for every hour starting at the analysis begin date.N/A
Top of Minute IntervalDateThe time for every minute starting at the top of the minute (seconds equals 0).N/A
Minute IntervalDateThe time for every minute starting at the analysis begin date.N/A



OEE Data Points

Data PointData TypeDescriptionUnits
OEE
Elapsed TimeFloat8Elapsed Time of current operation.minutes
OEEFloat8OEE value for selected period.N/A
OEE General CountLongAny count value other than infeed, outfeed, reject and waste value for the selected time period.N/A
OEE Infeed CountStringEquipment infeed count value for the selected period.N/A
OEE Infeed Count Equipment PathStringInfeed count tag collector path.N/A
OEE Outfeed CountStringEquipment outfeed count value for the selected period.N/A
OEE Outfeed Count Equipment PathStringOutfeed count tag collector path.N/A
OEE Reject CountLongEquipment reject count value for the selected period.N/A
Outfeed Standard CountFloat8Calculated expected outfeed based on standard rate and runtime. The runtime is based on the elapsed time, planned downtime and unplanned downtime. The Ignition schedules are not used when calculating the Outfeed Standard Count.N/A
Planned DowntimeFloat8Planned Downtime duration (Double) for selected period.minutes
RuntimeFloat8Runtime is the duration where the production item is in the run state. Runtime = Elapsed time minus Downtime.minutes
Short Stop TimeFloat8Short stop duration (Double) for selected period.minutes
Standard RateFloat8Standard rate of a machine (per minute).N/A
Standard Rate for HourDoubleStandard rate of a machine (per hour). This depends on the amount of time covered by shift segments within a given hour, rather than a flat hourly rate.N/A
Target Changeover TimeFloat8Amount of time in minutes set for Target Changeover. See Changeover Duration for more details.minutes
Unplanned Downtime Float8Unplanned Downtime duration (Double) for selected period.minutes
OEE/Availability
Is Short StopBooleanTrue if current equipment state is consider a shortstop. See Short Stop Threshold for more details.N/A
OEE AvailabilityFloat8OEE Availability value for selected period.N/A
OEE/Performance
OEE PerformanceFloat8OEE Performance value for selected period.N/A
Infeed Standard CountFloat8Calculated expected infeed based on standard rate, runtime, and package count. The runtime is based on the elapsed time, planned downtime and unplanned downtime. The Ignition schedules are not used when calculating the Infeed Standard Count.N/A
Equipment/OEE/Quality

OEE Quality

Float8OEE Quality value for selected period.N/A





Setting Values

The analysis results that are returned can be modified through the use of settings. Setting values provide a number of keywords as listed below.

Scripting with Setting Values

The format for entering the keywords: keyword1=True, keyword2=100.0, keyword3=10

Example: settings.setSettingsValues('Unknown State as Unplanned Downtime = True,Descending Order = True')

Settings like Enable Totalized Mode, Include Future, Last Values and Rollup Time span are meant for the Analysis Selector component only and not for Live Analysis.

SettingDescriptionUseExample
Filter Comparison Date FormatThe Filter Comparison Date Format is the comparator for Filter By expressions that include dates. This setting does not format Analysis Output data of Date/Datetime types. Data display formatting should be done in a display layer (i.e. Chart, Table, etc.). The Filter Comparison Date Format comparator setting is via string, e.g. 'YYYY-MM-dd HH:mm:ss', etc.AllFilter Comparison Date Format = 2017-11-15 17:04:00
Enable Totalized ModeThis setting accumulates the count. Useful for charts where you wish to display the accumulated production count over time.Not valid for Live AnalysisEnable Totalized Mode = True
Include FutureAllows for count values to be calculated in the future. Useful for charts where you want to display target counts for future runs.Not valid for Live AnalysisInclude Future = True
Last ValuesOnly the latest values are shown.Not valid for Live AnalysisLast Values = True
OEE Availability CapThe maximum value calculated can be capped with this setting.AllOEE Availability Cap = 1
OEE Performance CapThe maximum value calculated can be capped with this setting.AllOEE Performance Cap = 1
OEE Quality CapThe maximum value calculated can be capped with this setting.AllOEE Quality Cap = 1
Rollup Time Span

If the time (seconds) between downtime events is less than the rollup time and it is the same equipment and reason, then it will rollup the event into one row in the results and will increase the occurrence count.

Not valid for Live AnalysisRollup Time Span = 30
Suppress Grouping Messages

Suppresses any Analysis Messages that advise the user to add data points to the Group By list.

When Show Short Stops is set to True and Rollup Time Span is greater than 0, the OEE Downtime Table may pop up messages about the Is Short Stop column data being un-displayable, due to having "multiple unequal values". Setting Suppress Grouping Messages to True will prevent the pop up messages from occurring.

AllSuppress Grouping Messages = True
Row Limit

The analysis can be limited to a certain number of rows.

For OEE module version 2.9.3 SP10 and earlier: When Descending Order is set to true, the Row Limit is applied before the sort to descending order is performed (bug). Example: If there are three rows in the filtered results that contain "Line 1", "Line 2" and "Line 3", then when Descending Order is set to true and Row Limit =2, the two remaining rows will be: "Line 2" and then "Line 1" (this is incorrect).

Fixed in software version 2.9.3 SP11 (the two remaining rows will be: "Line 3" and then "Line 2").

AllRow Limit = 10
Descending OrderAnalysis results will be ordered in descending order if set to True.AllDescending Order = True
Include ChildrenSpecifies whether or not children of specified equipment are included in analysis calculationsAllInclude Children = True
Unknown State as Unplanned DowntimeTreat unknown states as unplanned downtime states.AllUnknown State as Unplanned Downtime = True
Historical Cache Key

Not in drop-down menu – must be typed into Name field.

Name of the key (string, no spaces or special characters) to point to a cached record of the analysis results. Once the analysis is run, a copy of the results is written to disk. If the same analysis is run again (with no changes to the filter properties), the results are pulled from the data file on disk instead of recalculated, to save processing time.

The cache file remains valid for the number of seconds set in Cache Expiration (see below).

AllHistorical Cache Key = Dec2019OEEAvailability
Cache Expiration

Not in drop-down menu – must be typed into Name field.

When an analysis is run with an Historical Cache Key name in place, the cached data associated with that key will remain valid for the number of seconds set here.

AllCache Expiration = 43200

  • No labels