statistics (material flow objects)

Syntax

<Path>.statistics
<Path>.statistics(Table:table_path)
<Path>.statistics(FileName:string[, CodePage:string])

The method statistics outputs the statistics of the object. When you do not enter a parameter, Plant Simulation outputs the table to a table on screen.

Parameters

Enter the parameter NameOfTable of data type table_path to write the data to that table.
Enter the parameter FileName of data type string to write the table to that file. Plant Simulation will overwrite existing entries.
If you specify a filename, you can use the optional parameter CodePage of data type string to set the encoding you want to use: ANSI, UTF-8, or Unicode.
If you do not specify this parameter, the encoding UTF-8 is used.

Example

MyStation.statistics                -- shows on the computer screen
MyStation.statistics(Stat_Tab)      -- writes into a table
MyStation.statistics("statistics")  -- writes to a file

Note:

Plant Simulation provides more statistics values than the table, which the method statistics returns, provides.

Each row of the resource statistics table shows the statistical data for an object. This table provides an overview of the entries on the table and their description:

Item	Shows the	Method
Name	name of the object the statistics were collected for (string).	—
Time	time of the statistics query (time).	—
Start (R)	time the resource statistics collection period of the object started (time).	—
Entries	number of MUs that entered the object as an integer. When an MU enters the object, it only counts the MU itself, not its contents: When a Container holding several parts enters the object, the number of entries increases by 1, not by the number of parts located on the Container!	StatNumIn
Exits	number of MUs that exited the object as an integer. When an MU exits the object, it only counts the MU itself, not its contents: When a Transporter holding several MUs leaves the object, the number of exits increases by 1, not by the number of MUs the Transporter transports!	StatNumOut
Contents	number of MUs, which are located on the object as an integer. The rules described under Entries apply.	NumMU
Predeposition	number of MUs, which are located on the object at the beginning of the statistics collection period. The rules described under Entries apply (integer).	StatPredeposition
Min_Cont	minimum number of MUs, which were located on the object as an integer. The rules described under Entries apply.	StatMinNumMU
Max_Cont	maximum number of MUs, which were located on the object as an integer. The rules described under Entries apply.	StatMaxNumMUs
%age_RelOccu (%_Util)	capacity-based ratio of the time during which the object was occupied, not paused and not failed to the time during which the object was not paused and not failed as a real number.	StatRelativeOccupation
%age_RelOccuIR (%_tUtil)	capacity-based ratio of the time during which the object was occupied in relation to the statistics collection period (real).	StatRelativeOccupationIR
%age_Wo	ratio of the time during which the object was Working to the statistics collection period.	StatWorkingPortion
Working	how often the object was working (integer).	StatWorkingCount
WorkingTime	total time during which the object was working (time).	StatWorkingTime
Wo_Mu	mean duration of the time spans during which the object was working (time).	StatWorkingMu
Wo_Delta	standard deviation of the time spans during which the object was working from the mean value (time).	StatWorkingDelta
%age_SU	ratio of the time during which the object was Setting-Up to the statistics collection period (real).	StatSetUpPortion
SetUp	how often the object was setting-up (integer).	StatSetUpCount
SetUpTime	total time during which the object was setting-up (time).	StatSetupTime
SU_Mu	mean duration of a set-up process (time).	StatSetUpMu
SU_Delta	standard deviation of the set-up from the mean value (time).	StatSetUpDelta
SetUpTime (Wa)	total time during which the object was setting-up and waiting (time).	provided for backward compatibility, is always -1
SetUpTime (Wo)	total time during which the object was setting-up and working (time).	provided for backward compatibility, is always -1
SetUpTime (B)	total time during which the object was setting-up and blocked (time).	provided for backward compatibility, is always -1
%age_Wa	ratio of the time during which the object was Waiting to the statistics collection period.	StatWaitingPortion
Waiting	how often the object was waiting (integer).	StatWaitingCount
WaitingTime	total time during which the object was waiting (time).	StatWaitingTime
Wa_Mu	mean duration of the objects waiting period (time).	StatWaitingMu
Wa_Delta	standard deviation of the waiting periods from the mean value (time).	StatWaitingDelta
%age_B	ratio of the time during which the object was Blocked to the statistics collection period.	StatBlockingPortion
Blocked	number of times during which the object was blocked (integer).	StatBlockingCount
BlockingTime	total time during which the object was blocked (time).	StatBlockingTime
B_Mu	mean duration of the time spans during which the object was blocked (time).	StatBlockingMu
B_Delta	standard deviation of the time spans during which the object was blocked from the mean value (time).	StatBlockingDelta
%age_Stp	ratio of the time during which the object was Stopped to the statistics collection period.	StatStoppedPortion
Stops	how often the object was stopped (integer).	StatStoppedCount
StoppedTime	total time during which the object was stopped (time).	StatStoppedTime
Stp_Mu	mean duration of a stopped time of the object (time).	StatStoppedMu
Stp_Delta	standard deviation of the stopped time from the mean value (time).	StatStoppedDelta
%age_F	ratio of the time during which the object was Failed to the statistics collection period.	StatFailPortion
Failures	how often the object was failed (integer).	StatFailCount
FailTime	total time during which the object was failed (time).	StatFailTime
F_Mu	mean duration of a failure of the object (time).	StatFailMu
F_Delta	standard deviation of the failure time from the mean value (time).	StatFailDelta
%age_P	ratio of the time during which the object was Paused to the statistics collection period.	StatPausingPortion
Pauses	how often the object was paused (integer).	StatPausingCount
PauseTime	total time during which the object was paused (time).	StatPausingTime
P_Mu	mean duration of a pause (time).	StatPausingMu
P_Delta	standard deviation of the length of pauses from the mean value (time).	StatPausingDelta
%age_E	ratio of the time during which the object was Empty to the statistics collection period.	StatEmptyPortion
Empty	how often the object was empty (integer).	StatEmptyCount
EmptyTime	total time during which the object was empty (time).	StatEmptyTime
E_Mu	mean duration of a time span during which the object was empty (time).	StatEmptyMu
E_Delta	standard deviation of the time spans during which the object was empty to the mean value (time).	StatEmptyDelta
%age_WaSU	ratio of the time the object was setting-up and for which Exporters were missing to the statistics collection period (real).	StatWaitingSetUpExpPortion
WaSetUpExp	how often the object was setting-up, while Exporters were missing (integer).	StatWaitingSetUpExpCount
WaSetUpExpTime	total time during which the object was setting-up and for which Exporters were missing (time).	StatWaitingSetUpExpTime
WaSUExp_Mu	mean duration of a setting-up process for which Exporters were missing (time).	StatWaitingSetUpExpMu
WaSUExp_Delta	standard deviation of a setting-up process for which Exporters were missing (time).	StatWaitingSetUpExpDelta
WaSetUpExpTime(Wa)	total time during which the object was set-up and waiting and for which Exporters were missing (time).	—
WaSetUpExpTime(Wo)	total time during which the object was set-up and processing and for which Exporters were missing (time).	—
WaSetUpExpTime(B)	total time during which the object was set-up and blocked and for which Exporters were missing (time).	—
%_WaExp	ratio of the time during which the object was waiting and for which Exporters were missing to the statistics collection period (real).	—
WaitingExp	how often the object was waiting, while Exporters were missing (integer).	—
WaitingTimeExp	total number of times during which the object was waiting and for which Exporters were missing (time).	—
WaExp_Mu	mean duration of a time span during which the object was waiting and for which Exporters were missing (time).	—
WaExp_Delta	standard deviation from the mean value of the waiting times for which Exporters were missing (time).	—
%age_BExp	ratio of the blocking time during which Exporters were missing to the statistics collection period (real).	—
BlocksExp	how often the object was blocked, while Exporters were missing (integer).	—
BlockingTimeExp	total time during which the object was blocked and for which Exporters were missing (time).	—
BExp_Mu	mean duration of a blockage of the object for which Exporters were missing (time).	—
BExp_Delta	standard deviation of the time spans during which the object was blocked from the mean value for which Exporters were missing (time).	—
%age_WaRes	time during which the object was waiting for MUs and for Exporters/Services in relation to the statistics collection period (real).	StatWaitingResPortion
WaitingRes	how often the object was blocked and waiting for MUs and for Exporters/Services (integer).	StatWaitingResCount
WaitingTimeRes	total time during which the object was blocked and was waiting for MUs and for Exporters/Services (time).	StatWaitingResTime
WaRes_Mu	mean duration of a period of time during which the object was blocked and was waiting for MUs and for Exporters/Services (time).	StatWaitingResMu
WaRes_Delta	mean deviation of the times during which the object was blocked and was waiting for MUs and for Exporters/Services (time).	StatWaitingResDelta
%age_WaParts	total time during which the object was waiting for MUs to the statistics collection period (real).	StatWaitingPartsPortion
WaitingParts	how often the object was blocked and was waiting for MUs (integer).	StatWaitingPartsCount
WaitingTimeParts	total time during which the AssemblyStation was blocked and was waiting for MUs (time).	StatWaitingPartsTime
WaParts_Mu	mean duration of a period of time during which the object was blocked and was waiting for MUs (time).	StatWaitingPartsMu
WaParts_Delta	mean deviation of the times during which the object was blocked and was waiting for MUs (time).	StatWaitingPartsDelta

The product statistics table of the MUs shows the following values.

If you query the statistics of an MU class, the values refer to the entire statistics collection period.
If you query the statistics of an individual MU, the values refer to the lifetime of that MU.

Item	Shows the	Method
Name	name of the MU the statistical data is interpreted for (data type string).	—
Time	current simulation time ( time).	—
Start (P)	time the product statistics collection of the object started (time).	—
%age_P_IP	time portion during which the MU was located on a material flow object of type Production and was processed. The sum of the columns %age_P_Wa, %age_P_IP, %age_P_Stp, %age_P_F, and %age_P_P of the Product Statistics Table shows the ratio of the time the MU was located on a material flow object of type Production to the entire statistics collection period.	StatProdWorkingPortion
%age_P_SU	time portion during which a resource of type Production was setting-up for this MU (real).	StatProdSetupPortion
%age_P_Wa	time portion during which the MU was located on a material flow object of type Production and was waiting. The sum of the columns %age_P_Wa, %age_P_IP, %age_P_Stp, %age_P_F, and %age_P_P of the Product Statistics Table shows the ratio of the time the MU was located on a material flow object of type Production to the entire statistics collection period.	StatProdWaitingPortion
%age_P_Stp	time portion during which the MU was located on a material flow object of type Production and was stopped. The sum of the columns %age_P_Wa, %age_P_IP, %age_P_Stp, %age_P_F, and %age_P_P of the Product Statistics Table shows the ratio of the time the MU was located on a material flow object of type Production to the entire statistics collection period.	StatProdStoppedPortion
%age_P_F	time portion during which the MU was located on a material flow object of type Production and was in a failed state. The sum of the columns %age_P_Wa, %age_P_IP, %age_P_Stp, %age_P_F, and %age_P_P of the Product Statistics Table shows the ratio of the time the MU was located on a material flow object of type Production to the entire statistics collection period.	StatProdFailPortion
%age_P_P	time portion during which the MU was located on a material flow object of type Production and was in a paused state. The sum of the columns %age_P_Wa, %age_P_IP, %age_P_Stp, %age_P_F, and %age_P_P of the Product Statistics Table shows the ratio of the time the MU was located on a material flow object of type Production to the entire statistics collection period.	StatProdPausingPortion
%age_T_IP	time portion during which the MU was located on a material flow object of type Transport and was processed. The sum of the columns %age_T_Wa, %age_T_IP, %age_T_F, and %age_T_P of the Product Statistics Table shows the ratio of the time the MU was located on a material flow object of type Transport to the entire statistics collection period.	StatTranspPausingPortion
%age_T_SU	time portion during which a resource of type Transport was setting-up for this MU (real).	StatTranspSetupPortion
%age_T_Wa	time portion during which the MU was located on a material flow object of type Transport and was waiting. The sum of the columns %age_T_Wa, %age_T_IP, %age_T_F, and %age_T_P of the Product Statistics Table shows the ratio of the time the MU was located on a material flow object of type Transport to the entire statistics collection period.	StatTranspWaitingPortion
%age_T_Stp	time portion during which the MU was located on a material flow object of type Transport and was stopped. The sum of the columns %age_T_Wa, %age_T_IP, %age_T_F, and %age_T_P of the Product Statistics Table shows the ratio of the time the MU was located on a material flow object of type Transport to the entire statistics collection period.	StatTranspStoppedPortion
%age_T_F	time portion during which the MU was located on a material flow object of type Transport and was in a failed state. The sum of the columns %age_T_Wa, %age_T_IP, %age_T_F, and %age_T_P of the Product Statistics Table shows the ratio of the time the MU was located on a material flow object of type Transport to the entire statistics collection period (real).	StatTranspFailPortion
%age_T_P	time portion during which the MU was located on a material flow object of type Transport and was in a paused state. The sum of the columns %age_T_Wa, %age_T_IP, %age_T_F, and %age_T_P of the Product Statistics Table shows the ratio of the time the MU was located on a material flow object of type Transport to the entire statistics collection period (real).	StatTranspPausingPortion
%age_S_IP	time portion during which the MU was located on a material flow object of type Storage and was processed. The sum of the columns %age_S_Wa, %age_S_IP, %age_S_F, and %age_S_P of the Product Statistics Table shows the ratio of the time the MU was located on a material flow object of type Storage to the entire statistics collection period.	StatStoreWorkingPortion
%age_S_SU	time portion during which a resource of type Storage was setting-up for this MU (real).	StatStoreSetupPortion
%age_S_Wa	time portion during which the MU was located on a material flow object of type Storage and was waiting. The sum of the columns %age_S_Wa, %age_S_IP, %age_S_F, and %age_S_P of the Product Statistics Table shows the ratio of the time the MU was located on a material flow object of type Storage to the entire statistics collection period.	StatStoreWaitingPortion
%age_S_Stp	time portion during which the MU was located on a material flow object of type Storage and was stopped. The sum of the columns %age_S_Wa, %age_S_IP, %age_S_F, and %age_S_P of the Product Statistics Table shows the ratio of the time the MU was located on a material flow object of type Storage to the entire statistics collection period.	StatStoreStoppedPortion
%age_S_F	time portion during which the MU was located on a material flow object of type Storage and was in a failed state. The sum of the columns %age_S_Wa, %age_S_IP, %age_S_F, and %age_S_P of the Product Statistics Table shows the ratio of the time the MU was located on a material flow object of type Storage to the entire statistics collection period.	StatStoreFailPortion
%age_S_P	time portion during which the MU was located on a material flow object of type Storage and was in a paused state. The sum of the columns %age_S_Wa, %age_S_IP, %age_S_F, and %age_S_P of the Product Statistics Table shows the ratio of the time the MU was located on a material flow object of type Storage to the entire statistics collection period (real).	StatStorePausingPortion
Count	number of existing MU instances of this class with product statistics on. The MUs may be located in different Frame hierarchies (integer).	statCount
Deleted	number of MUs, which were removed from the installation during statistics collection of the class. Plant Simulation only counts MUs for which you selected the check box Product statistics.	StatDeleted
avgLT/Average Lifespan	average life-span of MUs, which were created and removed from the installation during the statistics collection period. Plant Simulation only counts MUs for which you selected the check box Product statistics.	StatAvgLifeSpan

The drive statistics table of the Transporter shows these values:

Item	Shows the	Methods
Name	name of the object for which the statistical data of the row are evaluated (string).	—
Time	current simulation time (time).	—
OrderOcc	ratio of the time during which the Transporter had an order and was loaded to the life-span (real).	statOrderOccTime statOrderOccPortion
OrderEmpty	ratio of time during which the Transporter had an order and was not loaded to the life-span (real).	statOrderEmptyTime statOrderEmptyPortion
Home	ratio of the time during which the Transporter was returning to its base to the life-span (real).	statHomeDrivingTime statHomeDrivingPortion
Charges	how often the battery was charged (integer).	statBatChargeCount
%age_C	ratio of the time during which the battery of the Transporter was charging to the life-span.	statBatChargePortion
Tsp%age_F	ratio of the time during which the Transporter was in a failed state to the life-span (real).	StatTspFailPortion
TspFailures	number of failures during the total life-span (integer).	StatTspFailCount
TspFailTime	sum of all failure times during the total life-span of the Transporter (time).	StatTspFailTime
TspF_Mu	mean duration of a failure (time).	StatTspFailMu
TspF_Delta	standard deviation from the mean value (time).	StatTspFailDelta
Tsp%ageP	ratio of the time during which the Transporter was paused to the total life-span (real).	StatTspPausingPortion
TspPauses	number of pauses during the total life-span (integer).	StatTspPausingCount
TspPauseTime	sum of all pause-times of the Transporter (time).	StatTspPausingTime
TspP_Mu	mean duration of a pause (time).	StatTspPausingMu
TspP_Delta	standard deviation from the mean value (time).	StatTspPausingDelta

statistics (material flow objects)

Related Topics