TCalc EIQAI Software Specifications & AI Prediction Flow Explanation

Overview

EIQAI, an expansion module of the TCalc series, is a system that fundamentally transforms EIQ analysis (E = Entry/Destinations, I = Items, Q = Quantity)—the traditional methodology used in distribution centers.
Developed as a Windows Forms application, this software embeds advanced trained models from Microsoft.ML (ML.NET) to execute high-precision AI predictions for future volume fluctuations, extending beyond static historical data aggregation.

Purpose

The primary objective of this system is to perform comprehensive logistics simulations from minimal input data and generate detailed EIQ matrices.
By specifying just two input parameters—"number of delivery destinations" and "number of items"—the system automatically computes AI predictions for 162 variable parameters required for EIQ analysis.
Specifically, it instantly calculates everything from basic indicators like loose quantities and line counts to destination ranks (E1–E5), item ranks (I1–I5), and 25 rank-based metrics covering line counts, loose items, cases, pallets, volume, and weight.
To make these extensive forecast results intuitive, the system visualizes them on-screen as EIQ matrix tables and traditional calculation views, powerfully supporting distribution center engineering and capacity planning.

Operating Environment & Tech Stack

This system adopts the following technical stack to deliver high performance and secure local execution:

Framework.NET Framework 4.8 / Windows Forms (VB.NET)
AI/ML LibraryMicrosoft.ML (ML.NET 6.0 Preview)
DatabaseMicrosoft Access (.accdb) ─ Auto-compacted on startup (JRO.JetEngine)
Model FormatPre-trained ITransformer (.zip) ─ Batch loads 162 AI prediction models
Data Storage PathTeraCalculationData\EIQAnalysisAI folder (Auto-detects drives A to F)
Excel ExportEPPlusFree Library supported

Key Features

Development Information

DeveloperLogistics Technology Research Institute
CopyrightToshiyuki Teramoto

Overall System Flow

Below is the overall operational flow in TCalc EIQAI from application launch to EIQ matrix rendering and error verification:

App Startup (Form Load)
▼
Initialization Process
MLContext / Load Models / Init Dgv
▼
User Input
Destinations & Item Counts
▼
Click Execute Prediction Btn
▼
Execute Prediction()
Predict via all models → Display in Prediction Dgv
▼
Click Execute EIQ Matrix Btn
▼
Build Matrix Table
Build Traditional E
Build Traditional I
▼
Switch Display Unit Radio Buttons
Frequency / Loose / Case / PL / Volume / Weight → Re-render Matrix
▼
Aggregate DB Actuals & Display Comparison
Display Actuals → Display Prediction Error Margin

Detailed Step Descriptions

【1】 Form Load (TeraCalculationEIQAI_Load)

The initialization process executed when launching the application:

【2】 Execute Prediction (ExecutePredictionBtn_Click → ExecutePrediction())

The core process running actual AI predictions triggered by user input:

【3】 Build EIQ Matrix Table (AIPredictionEIQMatrixTable())

Reconstructs calculated prediction metrics into a visual EIQ matrix:

GPLE RankGPLI_A1GPLI_A2GPLI_BGPLI_CGPLI_DRow Sum
GPLE_A1XX01XX02XX03XX04XX05ΣRow
GPLE_A2XX06XX07XX08XX09XX10ΣRow
GPLE_BXX11XX12XX13XX14XX15ΣRow
GPLE_CXX16XX17XX18XX19XX20ΣRow
GPLE_DXX21XX22XX23XX24XX25ΣRow
Col SumΣColΣColΣColΣColΣColGrand Total
* XX = Active unit prefix (Line Count / Loose Qty / Case / PL / Volume / Weight)

【4】 Traditional Calculation E (AIPredictionTraditionalCalcE())

Re-aggregates AI prediction data across destination ranks (E) from traditional perspectives:

Ship DateRankDestinationsFrequencyLoose QtyCase Equiv.PL Equiv.Volume Equiv.Weight Equiv.
All-Data AvgGPLE_A1E1ΣLines 01–05ΣLoose 01–05ΣCase 01–05ΣPL 01–05ΣVolume 01–05ΣWeight 01–05
All-Data AvgGPLE_A2E2ΣLines 06–10ΣLoose 06–10ΣCase 06–10ΣPL 06–10ΣVolume 06–10ΣWeight 06–10
All-Data AvgGPLE_BE3ΣLines 11–15ΣLoose 11–15ΣCase 11–15ΣPL 11–15ΣVolume 11–15ΣWeight 11–15
All-Data AvgGPLE_CE4ΣLines 16–20ΣLoose 16–20ΣCase 16–20ΣPL 16–20ΣVolume 16–20ΣWeight 16–20
All-Data AvgGPLE_DE5ΣLines 21–25ΣLoose 21–25ΣCase 21–25ΣPL 21–25ΣVolume 21–25ΣWeight 21–25
TotalΣEΣAllΣAllΣAllΣAllΣAllΣAll

【5】 Traditional Calculation I (AIPredictionTraditionalCalcI())

Re-aggregates AI prediction data across item ranks (I) from traditional perspectives:

Ship DateRankItemsFrequencyLoose QtyCase Equiv.PL Equiv.Volume Equiv.Weight Equiv.
All-Data AvgGPLI_A1I1ΣLines col1ΣLoose col1ΣCase col1ΣPL col1ΣVolume col1ΣWeight col1
All-Data AvgGPLI_A2I2ΣLines col2ΣLoose col2ΣCase col2ΣPL col2ΣVolume col2ΣWeight col2
All-Data AvgGPLI_BI3ΣLines col3ΣLoose col3ΣCase col3ΣPL col3ΣVolume col3ΣWeight col3
All-Data AvgGPLI_CI4ΣLines col4ΣLoose col4ΣCase col4ΣPL col4ΣVolume col4ΣWeight col4
All-Data AvgGPLI_DI5ΣLines col5ΣLoose col5ΣCase col5ΣPL col5ΣVolume col5ΣWeight col5
Col SumΣIΣAllΣAllΣAllΣAllΣAllΣAll
Column sums: GPLI_A1 = XX01+XX06+XX11+XX16+XX21, GPLI_A2 = XX02+XX07+XX12+XX17+XX22, …

【6】 Switch Display Unit (Filter_DisplayUnit_CheckedChanged)

UI handler dynamically updating EIQ matrix content:

【7】 Export Results (ExportResultsBtn_Click)

Export handler for external data integration:

【8】 Reload Trained Models (LoadTrainedModelsBtn_Click)

【9】 Compare Predictions with Actuals (StartComparisonBtn_Click)

Data Structures

Data structure reference managed within TCalc EIQAI:

Class NamePurposePrimary Fields
ModelDataTraining Data StructureModel Serial, Destinations, Items, Loose Qty, Line Count, E1–E5, I1–I5, Lines 01–25, etc.
InputDataPrediction InputDestinations, Items
SinglePredictionPrediction OutputScore

Primary UI Controls List

Reference list of primary UI controls deployed on screen:

Inputs

ControlDescription
DestinationCountTbDestination Count Input Textbox
ItemCountTbItem Count Input Textbox

Buttons

ControlDescription
LoadTrainedModelsBtnReload Models
ExecutePredictionBtnExecute AI Prediction
ExecuteEIQMatrixBtnGenerate Matrix & Traditional Tables
ExportResultsBtnExport to CSV
StartComparisonBtnCompare Predictions vs. Actuals
CloseBtnClose Form

Display Unit Radio Buttons

ControlPrefix
Filter_FrequencyRbLine Count
Filter_LooseRbLoose Qty
Filter_CaseRbCase
Filter_PLRbPL
Filter_VolumeRbVolume
Filter_WeightRbWeight

DataGridViews

ControlDescription
PredictionResultsDgvComplete Predictions List (Item Name / Predicted Value)
AIPredictionEIQMatrixDgv5×5 EIQ Matrix Table + Row/Col Sums
AIPredictionTraditionalCalcDestinationDgvTraditional Calc E (Aggregated by Destination Rank)
AIPredictionTraditionalCalcItemDgvTraditional Calc I (Aggregated by Item Rank)
AIPredictionEIQMatrixCopyDgvCopy View for Actuals Comparison
ActualCalcDgvDisplay Actual Calculated Values
ErrorDgvDisplay Variance between AI Prediction and Actuals in %

Extracted Textboxes

ControlMapped Metric
ExtractedE_A1Tb to ExtractedE_DTbE1 to E5
ExtractedE_TotalTbSum of E1 to E5
ExtractedI_A1Tb to ExtractedI_DTbI1 to I5
ExtractedI_TotalTbSum of I1 to I5

Helper Functions

Internal utility functions:

FunctionDescription
ToRoundedString(s)Converts string to numeric, rounds to nearest integer, and returns as string
ToLongOrZero(s)Converts string to Long (returns 0 on failure)