--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/Docu/Performance-Measurement.txt	Thu Sep 19 12:01:29 2019 +0200
@@ -0,0 +1,40 @@
+
+Performance Measurement
+-----------------------
+
+When compiled in, the dive mode screen shows 5 performance data values:
+
+AAAA.BBB.CC.DD.EE
+
+AAAA: Relative runtime of the last deco engine invocation, in ms,
+      signed value: positive numbers: longer than target
+                    negative numbers: unused time budget
+
+BBB:  longest runtime found, in ms
+
+CC:   Calculation phase in which the longest runtime occurred, see table below
+
+DD:   Number of deco engine invocations required to complete the last normal plan
+
+EE:   as above, but for alternative plan
+
+
+Calculation Phases
+------------------------------------------------------------------------------------------------------
+
+PHASE_00_DONE					00	calculation cycle finished
+PHASE_10_DIVE_INIT				10	once-per-dive    initialization of the deco engine
+PHASE_11_CYCLIC_INIT			11	once-every-cycle initialization of the deco engine
+PHASE_20_EXTENDED_BOTTOM_TIME	20	calculate extended bottom time
+PHASE_30_NDL_TIME				30	calculate NDL time
+PHASE_40_CAVE_ASCENT			40	calculate cave mode return/ascent
+PHASE_50_INITIAL_ASCENT			50	calculate initial ascent
+PHASE_60_DECO_STOPS				60	calculate deco stops
+PHASE_70_RESULTS				70	results - initialization
+PHASE_71_RESULTS_STOPS_TABLE	71	results - publish stops table
+PHASE_72_RESULTS_NDL			72	results - publish data / within NDL
+PHASE_73_RESULTS_DECO			73	results - publish data / in deco
+PHASE_80_GAS_NEEDS_SWITCHES		80	calculate gas needs - find gas switches in NDL bailout mode
+PHASE_81_GAS_NEEDS_ASCENT		81	calculate gas needs - needs of bottom segment and ascent
+PHASE_82_GAS_NEEDS_PRESSURES	82	calculate gas needs - conversion from volumes to pressures
+PHASE_90_FINISH					90	finish calculation cycle
\ No newline at end of file