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 MES Equipment Manager 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.

DateTime Tags Display Differently in Ignition 7 versus Ignition 8


DateTime Tags in Ignition 7 and Ignition 8

As an example, consider two Ignition Gateways, one is Ignition 7, the other Ignition 8. Both gateways are set to UTC, while the Designer/Client machine is set to PST. There is a 7 hour difference between UTC and PST.

In Ignition 7, Date tags translate to PST.

In Ignition 8, Date tags show as UTC



To create a new Live Analysis:

  • Click on Live Analysis in the MES Equipment Manager.
  • 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.

    If the Gateway is licensed to use Settings & Changeover module, the "Current Active Recipe Period" Live Analysis period will be enabled for use.
  • 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 in the MES Equipment Manager

Watch the Video


MES Tag Provider Live Analysis Tags





Live Analysis Settings

SettingDescription

Analysis Name

The name for the live analysis

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.
  • Current Active Recipe Period - This duration starts from the beginning of the current active recipe selection, and ends upon recipe cancellation or change.
  • 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

Example: filter_expression = "Shift='Morning' AND (Line State Type='Planned Downtime' OR Line State Type='Unplanned Downtime' OR Line State Type='Unknown')"

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.

Equipment Data Points

Data PointData TypeDescriptionUnits
Equipment

Equipment Cell Order

Int4Integer value that determines the cell order of the equipment within the line. The key cell is always order 0. This means that the index shifts based on where the key cell is. 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.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



Watch the Video


On this Page

Equipment Additional Factors

Data PointData TypeDescriptionUnits
Equipment/Additional Factors

<additional_factor_name>.TimeStamp

String

When a string data type tag is used to create a new, user-defined Additional Factor, one additional data point will automatically be created and maintained for each:

  • TimeStamp – The DateTime that this Additional Factor value was last updated (see image below).
N/A

<additional_factor_name>.Min
<additional_factor_name>.Max
<additional_factor_name>.Median
<additional_factor_name>.Mean
<additional_factor_name>.Standard Deviation
<additional_factor_name>.TimeStamp

Int1, Int2, Int4, Int8, Float4, Float8

When tags of the numeric data types listed to the left are used to create a new, user-defined Additional Factor, six additional data points will automatically be created and maintained for each (calculations are performed using all of the resulting values from that analysis run):

  • Min – The lowest value among the results.
  • Max – The highest value among the results.
  • Median – The sum of all the resulting values divided by the number of results.
  • Mean – The value where half of the remaining resulting values are larger and half are smaller. For even numbers of values, the mid-point between the mean two values is returned.
  • Standard Deviation – (calculated as Sample Standard Deviation) The square root of the average of the squared individual differences of each resulting value from the calculated mean.
  • TimeStamp – The DateTime that this Additional Factor value was last updated.

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

Float8 See Package Count for more details.N/A

Equipment Reject Scale

Float8 See 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 (Counters section of the MES Equipment Manager under General). 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 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)

Cycle Time Length

Type

Time Calculation

Value

Overall Cycle Time

t analysis

10 minutes

Normal Cycle Time

tanalysis - t 2

9 minutes

Precise Cycle Time

t analysis - (t 2 + t 6 )

7 minutes

Min Cycle Time (note)

Type

Cycle Time Calculation

Min Cycle Time (mins)


Min Overall Cycle Time

C1 overall: t0 = 2 mins

C2 overall: t 1 +t 2+t 3 = 3 mins

C3 overall: t 4 = 2 mins


2 minutes


Min Normal Cycle Time

C1 normal: t 0 = 2 mins

C2 normal: t1+t3 = 2 mins

C3 normal: t4 = 2 mins


2 minutes


Min Precise Cycle Time

C1 precise: t 0 = 2 mins

C2 precise: t1+t3 = 2 mins

C3 precise: 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 + C2 overall + C3 overall) / 3 cycles

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

2.33 minutes

Average Normal Cycle Time

(C1normal + C2 normal + C3 normal) / 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)

Type

Time Calculation

Value

Overall Cycle Time

t analysis

10 minutes

Normal Cycle Time

tanalysis

10 minutes

Precise Cycle Time

tanalysis - t 9

6 minutes

Min Cycle Time (note)

Type

Cycle Time Calculation

Min Cycle Time (mins)


Min Overall Cycle Time

C4 overall : t 7 +t 8 +t 9 +t 10 = 8 mins

C5 overall: t11 = 2 mins

C6 overall: t12 = 2 mins


2 minutes


Min Normal Cycle Time

C4 normal: t 7 + t 8 + t 9 +t 10 = 8 mins

C5 normal: t11 = 2 mins

C6 normal: t12 = 2 mins


2 minutes


Min Precise Cycle Time

C4 precise: t 7 +t 10 = 2 mins

C5 precise: t11 = 2 mins

C6 precise: 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 + C5 overall + C6 overall) / 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)

Cycle Time Length

Type

Time Calculation

Value

Overall Cycle Time

t analysis

10 minutes

Normal Cycle Time

tanalysis - t 20

9 minutes

Precise Cycle Time

tanalysis - t 20

9 minutes

Min Cycle Time (note)

Type

Cycle Time Calculation

Min Cycle Time (mins)



Min Overall Cycle Time

C7 overall : t 14 +t 15 = 2 mins

C8 overall: t16 = 2 mins

C9 overall: t 17 = 2 mins

C10 overall: t 18 = 2 mins

C11 overall: t 19 = 2 mins



2 minutes



Min Normal Cycle Time

C7 normal: t14+t15 = 2 mins

C8 normal: t16 = 2 mins

C9 normal: t17 = 2 mins

C10 normal: t18 = 2 mins

C11 normal: t19 = 2 mins



2 minutes



Min Precise Cycle Time

C7 precise: t14+t15 = 2 mins

C8 precise: t16 = 2 mins

C9 precise: t17 = 2 mins

C10 precise: t18 = 2 mins

C11 precise: 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 + C10 overall + C11 overall)/ 5 cycles

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

2.00 minutes

Average Normal Cycle Time

(C7normal + C8normal + C9normal + C10 normal + C11 normal)/ 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)

Cycle Time Length

Type

Time Calculation

Value

Overall Cycle Time

t analysis

10 minutes

Normal Cycle Time

tanalysis - t22

6 minutes

Precise Cycle Time

tanalysis - t 22

6 minutes

Min Cycle Time (note)

Type

Cycle Time Calculation

Min Cycle Time (mins)


Min Overall Cycle Time

C12 overall: t21+t22 +t 23 = 7 mins

C13 overall: t24 = 2 mins

C14 overall: t25 = 2 mins


2 minutes


Min Normal Cycle Time

C12 normal: t23 = 2 mins

C13 normal: t24 = 2 mins

C14 normal: t25 = 2 mins


2 minutes


Min Precise Cycle Time

C12 precise: t23 = 2 mins

C13 precise: t24 = 2 mins

C14 precise: 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)

Cycle Time Length

Type

Time Calculation

Value

Overall Cycle Time

t analysis

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

C15 overall: t26 = 2 mins

C16 overall: t27 = 2 mins

C17 overall: t28 = 2 mins

C18 overall: t 29 = 2 mins

C19 overall: t 30 = 2 mins



2 minutes



Min Normal Cycle Time

C15 normal: t26 = 2 mins

C16 normal: t27 = 2 mins

C17 normal: t28 = 2 mins

C18 normal: t29 = 2 mins

C19 normal: t30 = 2 mins



2 minutes



Min Precise Cycle Time

C15 precise: t26 = 2 mins

C16 precise: t27 = 2 mins

C17 precise: t28 = 2 mins

C18 precise: t29 = 2 mins

C19 precise: 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 + C18 overall + C19 overall)/ 5 cycles

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

2.00 minutes

Average Normal Cycle Time

(C15normal + C16normal + C17normal + C18 normal + C19 normal)/ 5 cycles

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

2.00 minutes

Average Precise Cycle Time

(C15precise + C16precise + C17precise + C18 precise + C19 precise)/ 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

Float8 Also 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

Float8 Max Normal cycle time in minutes. minutes

Min Normal Cycle Time

Float8 Min Normal cycle time in minutes. minutes

Normal Cycle Time

Float8 Time 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

Float8 Average Overall cycle time in minutes. minutes

Max Overall Cycle Time

Float8 Max Overall cycle time in minutes. minutes

Min Overall  Cycle Time

Float8 Min Overall cycle time in minutes. minutes

Overall Cycle Time

Float8 Time 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

Float8 Average Precise cycle time in minutes. minutes

Max Precise  Cycle Time

Float8 Max Precise cycle time in minutes. minutes

Min Precise Cycle Time

Float8 Min Precise cycle time in minutes. minutes

Precise Cycle Time

Float8 Time 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 SplitBooleanTrue if the line downtime reason split can be reverted.N/A
Line Downtime End State Time Stamp DateTime When 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 PathStringThe original path of the equipment that caused the line downtime before being reassigned to differed equipment.N/A
Line Downtime Original ReasonStringThe line or cell group (sub line) original downtime reason.N/A
Line Downtime Original Reason CodeInt4The 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 Duration Double Scheduled 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/Schedule/Entries
Calculated Scheduled QuantityFloat8The sum of all (request segment duration (minutes) * rate (converted to minutes)) for segments in a available time.production units
Entry Begin Date TimeDateTimeThe begin time of the Operations Request.N/A
Entry End Date TimeDateTimeThe end time of the Operations Request.N/A
Entry Request Segment End Date TimeDateTimeThe End Time of Request Segments in the Operations Request.N/A
Entry Schedule TypeStringThe equipment operation schedule type, either "Held" or "Active".N/A
Entry Scheduled DurationFloat8The duration of a scheduled operation in minutes (only valid if the Entry Scheduled Method is set to "Duration"). Note: Value is 0 when Entry Scheduled Method is set to "Count".minutes
Entry Scheduled MethodStringThe equipment operation scheduling method, either "Count" or "Duration".N/A
Entry Scheduled QuantityInt4The output count of a scheduled operation (only valid if the Entry Scheduled Method is set to "Count"). Note: Value is null when Entry Scheduled Method is set to "Duration".production units
Entry Scheduled RateFloat8The "Rate" from the Material Property on the Segment. Note that units are either hours or minutes based on the Entry Schedule Rate Period setting.production units/unit of time (hours or minutes)
Entry Scheduled Rate PeriodStringThe "Rate Period" property from the Material Property on the Segment, either "None", "Hour", "Min", or "Cycle".N/A
Operations Request NameStringThe Name of the Operations Request object.N/A
Operations Request UUIDStringThe UUID of the Operations Request object.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 OverriddenBoolean Overriding 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 and States for more details.N/A

Equipment Mode Type

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

Equipment Mode Value

Int4Name of the current mode. See Equipment Modes and States 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 Time DateTime

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.



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 date time of the current period (run time of the analysis).N/A
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 Week Int4 Int value of the current day of the week.N/A
Shift Day of Year Int4 Int value of the current day of the year.N/A
Shift ISO Week of Year Int4 Int 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 Date DateTime

Calendar start date of the shift. Since this is a Java DateTime object, it will show midnight as the time.  Only the date is accurate.

Example 1: If a shift starts at 10PM on Day 1 and continues to 6AM on Day 2, then the Shift Start Date will be set to Day 1 (midnight), not Day 2.

Example 2: If a shift starts at 10PM on Day 1, has a break at 1AM, resumes at 2AM, and continues until 6AM, then the Shift Start Date will be set to Day 1 (midnight), not Day 2. 

In both examples above, the start of the shift is the start time following the single longest gap in that particular shift (10PM). Thus, the Shift Start Date will be set to Day 1 (midnight).

N/A
Shift Start Date Time DateTime

Start date time of the current shift. Both the date and the time will be accurate.

Refer to the examples for Shift Start Date above, except the resulting value will also include the shift's start time in addition to the date (10PM on Day 1).

N/A
Shift Week of MonthInt4Int value of the current week of the month.N/A
Shift Week of Year Int4 Int value of the current week of the year.N/A
Shift Year Int4 Int value of the current year.N/A
To Time Stamp DateTime End time (minutes) of the current period (run time of the analysis).minutes
General/Time


Month Of YearDate

The interval unit is one month for every month starting at the beginning of a year.

Included in Sepasoft Versions:

MES 3.81.3 and later
MES 3.79.3 and later

months
Top of MonthDate

Starting at the beginning of the month and time interval is a month.

Included in Sepasoft Versions:

MES 3.81.3 and later
MES 3.79.3 and later

month
Thirty Minute Interval DateThe time for every thirty minutes starting at the analysis begin date.N/A
Fifteen Minute Interval  Date The 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 Interval Date The 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
OEE Float8 OEE value for selected period.N/A
OEE General Count Long Any 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 Path String Infeed count tag collector path.N/A
OEE Outfeed CountStringEquipment outfeed count value for the selected period.N/A
OEE Outfeed Count Equipment Path String Outfeed count tag collector path.N/A
OEE Reject Count Long Equipment 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 Downtime Float8 Planned Downtime duration (Double) for selected period.minutes
Runtime Float8 Runtime is the duration where the production item is in the run state. Runtime = Elapsed time minus Downtime.minutes
Short Stop Time Float8 Short stop duration (Double) for selected period.minutes
Standard Rate Float8 Standard 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 Time Float8 Amount of time in minutes set for Target Changeover. See Changeover Duration for more details.minutes
Unplanned Downtime  Float8 Unplanned 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 Availability Float8 OEE Availability value for selected period.N/A
OEE/Performance
OEE Performance Float8 OEE 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
OEE/Quality

OEE Quality

Float8 OEE Quality value for selected period.N/A



Settings & Changeover Data Points

Data PointData TypeDescriptionUnits
Recipe
Active Recipe NameStringName of the currently-active recipe. See Selecting and Downloading Recipes for details.N/A
Active Recipe UUIDStringUUID of the currently-active recipe. See Selecting and Downloading Recipes for details.N/A
Recipe EnabledBooleanIf true, a recipe is currently active on the equipment.N/A
Recipe Scale Float8 The scale value set for the selected recipe.N/A
Recipe Tracking UUIDStringThe unique identifier (UUID) for the current recipe. See the Recipe Tracking UUID property on the Recipe Variance Viewer page for details.N/A
Recipe Tracking UUID SequenceIntegerThis number increments each time the Recipe UUID changes. It is useful for detecting when a new recipe has been selected.N/A
Recipe Type CodeInteger

Provides an integer instead of a string with the Recipe Type Name. Returns one of the following values:

  • 0 = Sub-Recipe
  • 1 = Recipe
N/A
Recipe Type NameString

The Recipe Type Name string provided for the selected recipe. Returns one of the following values:

  • "Sub-Recipe"
  • "Recipe"
N/A
Recipe/Time Stamp
Active Recipe Time Stamp DateTime The Time Stamp when the recipe was selected.N/A
Recipe Variance Time Stamp DateTime The Time Stamp of the variance event in the selected recipe. It records the DateTime of any setpoint value change, regardless of whether it is away from the default setpoint value or back to it.N/A
Recipe/Value
Recipe From ValueStringThe previous value when a recipe has been modified.N/A
Recipe Set Point DescriptionStringThe Description text string provided for the Set Point in the modified recipe.N/A
Recipe Set Point NameStringThe Name string provided for the Set Point in the modified recipe.N/A
Recipe Set Point UUIDStringThe UUID provided for the Set Point in the modified recipe.N/A
Recipe Set Point UnitsStringThe Units text string provided for the Set Point in the modified recipe.N/A
Recipe Set Point ValueStringThe current value of the Set Point in the modified recipe.N/A
Recipe To ValueString

The current value when a recipe has been modified.

N/A



SPC Data Points

Data PointData TypeDescriptionUnits
SPC/Status
Sample Coming DueBooleanIf true at the time of the row, a sample is/was coming due.N/A
Sample  DueBooleanIf true at the time of the row, a sample is/was due.N/A
Sample OverdueBooleanIf true at the time of the row, a sample is/was overdue.N/A
Sample Waiting ApprovalBooleanIf true at the time of the row, a sample is/was waiting to be approved.N/A
Signal Out of ControlBooleanIf true at the time of the row, any signal for any sample is/was out of control for the location.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.setSettingValues('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.


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.

SettingDescriptionUseExample
Filter Comparison Date Format The 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 LimitThe analysis can be limited to a certain number of rows.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