The Valve Phase Matrix provides a comprehensive grid view of all Engineering Item states and Equipment Module configurations across every step in a process. It is a powerful editing and analysis tool that lets you see and modify the complete state picture at a glance.
Access: Open a module → Module Ribbon → Live Edit panel → Matrix button.
🔎 Overview
The matrix displays a grid where:
-
Rows represent Engineering Items (valves, pumps, tanks, etc.) and Equipment Modules
-
Columns represent steps (phases) in the active Process
-
Cells show the assigned State for each Engineering Item in each step, or the active configuration for each Equipment Module
The matrix updates live — any changes made in the drawing, ribbon, or other editors are immediately reflected in the grid.
🧩 Cell Types
There are two kinds of cells in the matrix:
|
Cell Kind |
Row Type |
Cell Shows |
|---|---|---|
|
Engineering Item state |
Engineering Item row |
The state name assigned to the item in that step. Also shows a color bullet matching the state color. |
|
Equipment Module configuration |
Equipment Module row |
The active configuration name for the Equipment Module in that step. Equipment Module rows have a pale yellow background for visual distinction. |
🎨 Color Coding
The matrix uses background colors to highlight important information about each cell. Colors are applied with a clear priority hierarchy:
Warning: Color coding requires the highlight toggles to be enabled in the toolbar (see Highlighting section below).
🏆 Color Priority (Highest to Lowest)
|
Priority |
Color |
Meaning |
When Applied |
|---|---|---|---|
|
1 |
Gold |
Paste preview — Shows which cells will be affected before you commit a paste operation |
Active during clipboard paste preview mode |
|
2 |
Yellow-Green |
Dual highlight — The item is BOTH allowing fluid flow AND changing state in this step |
Both highlight toggles are ON, and both conditions are true |
|
3 |
Light Green |
Fluid allowing — The item allows fluid to pass through in this step |
"Highlight Fluid Allowing" is ON and the item passes fluid |
|
4 |
Orange |
State changing — The item changes its state compared to the previous step |
"Highlight Changing" is ON and the state differs from the prior step |
|
5 |
Transparent |
No highlight — Normal state, no special condition |
Default when no highlights match |
🏭 Pharma Example: CIP Process Matrix
This example shows how the Valve Phase Matrix looks for a typical CIP (Clean-In-Place) process with 10 Engineering Items across 6 phases.
📋 Process: CIP Skid — Tank TK-101
Phases: Idle, Pre-Rinse, Caustic Wash, Intermediate Rinse, Acid Wash, Final Rinse
|
Engineering Item / Equipment |
Idle |
Pre-Rinse |
Caustic Wash |
Intermediate Rinse |
Acid Wash |
Final Rinse |
|---|---|---|---|---|---|---|
|
V-101 (CIP Supply Inlet) |
Closed |
Open |
Open |
Open |
Open |
Open |
|
V-102 (CIP Return) |
Closed |
Open |
Open |
Open |
Open |
Open |
|
V-103 (Tank Drain) |
Closed |
Closed |
Closed |
Closed |
Closed |
Closed |
|
V-104 (Caustic Dosing) |
Closed |
Closed |
Open |
Closed |
Closed |
Closed |
|
V-105 (Acid Dosing) |
Closed |
Closed |
Closed |
Closed |
Open |
Closed |
|
V-106 (CIP Spray Ball) |
Closed |
Open |
Open |
Open |
Open |
Open |
|
V-107 (Product Inlet Block) |
Closed |
Closed |
Closed |
Closed |
Closed |
Closed |
|
V-108 (Product Outlet Block) |
Closed |
Closed |
Closed |
Closed |
Closed |
Closed |
|
V-109 (Vent Valve) |
Open |
Closed |
Closed |
Closed |
Closed |
Closed |
|
V-110 (Condensate Drain) |
Open |
Closed |
Closed |
Closed |
Closed |
Closed |
|
EM-CIP-Pump-01 |
Idle |
Running |
Running |
Running |
Running |
Running |
🔍 Reading the Matrix
With highlighting enabled, here is what you would observe:
-
Transition from Idle to Pre-Rinse: V-101, V-102, V-106 change from Closed to Open (highlighted in orange as state-changing). V-109 and V-110 change from Open to Closed (also orange). Since V-101, V-102, and V-106 are now fluid-allowing AND state-changing, they appear in yellow-green (dual highlight).
-
Transition from Pre-Rinse to Caustic Wash: Only V-104 changes (Closed to Open), highlighted in orange. V-104 is also now fluid-allowing, so it gets the yellow-green dual highlight.
-
Transition from Caustic Wash to Intermediate Rinse: Only V-104 changes back (Open to Closed), highlighted in orange. All other items remain unchanged.
-
Transition from Intermediate Rinse to Acid Wash: Only V-105 changes (Closed to Open), highlighted in orange and yellow-green (dual).
-
Product isolation: V-107 and V-108 remain Closed throughout — these are product-side block valves that must stay shut during CIP to prevent cross-contamination.
Tip: Use the "Filter Changing from Previous" filter to quickly see only the items that change in each phase transition.
🔦 Highlighting Options
Two toggle buttons in the matrix toolbar control which highlights are visible:
|
Toggle |
Effect |
|---|---|
|
Highlight Fluid Allowing |
When ON, cells where the item allows fluid flow are highlighted in Light Green (or Yellow-Green if also changing) |
|
Highlight Changing |
When ON, cells where the item's state differs from the previous step are highlighted in Orange (or Yellow-Green if also fluid-allowing) |
Both toggles can be active simultaneously. When both are ON and a cell matches both conditions, it receives the Yellow-Green dual highlight color.
🖥️ Cell Display Options
The matrix toolbar provides controls for how cell content is displayed:
|
Option |
Description |
|---|---|
|
Show Color Bullet |
Displays a colored dot next to the state text, matching the state's configured color |
|
Show State Names |
Shows the full state name in each cell |
|
Show State Nicknames |
Shows abbreviated nicknames instead of full names |
🏷️ Custom Nicknames
You can define custom short nicknames for common states to keep the matrix compact.
📐 Column Orientation
|
Option |
Description |
|---|---|
|
Vertical Columns |
When ON, step column headers are displayed vertically, saving horizontal space when you have many steps |
🔍 Filtering
The matrix provides extensive filtering to help you focus on the items that matter:
👁️ Row Visibility Filters
|
Filter |
Description |
|---|---|
|
Hide Unused |
Hides Engineering Items that have no state assigned in any step of the current process |
|
Hide In Equipment |
Hides items that belong to an Equipment Module |
|
Hide Not In Equipment |
Hides items that do NOT belong to any Equipment Module |
|
Hide Equipment Module Rows |
Hides the Equipment Module configuration rows entirely |
|
Show Untagged |
Shows items that have no tag assigned (hidden by default) |
⚡ Active-Step Relative Filters
These three filters are mutually exclusive — only one can be active at a time:
|
Filter |
Shows Only |
|---|---|
|
Filter Open in Active Phase |
Items that are in a fluid-allowing state in the active step |
|
Filter Closed in Active Phase |
Items that are in a fluid-denying state in the active step |
|
Filter Changing from Previous |
Items whose state changed compared to the previous step |
🔎 Search and Type Filters
|
Filter |
Description |
|---|---|
|
Search Text |
Free-text search that matches against item tags and names (case-insensitive) |
|
Type Filter |
Multi-select dropdown to show/hide specific Engineering Item types |
🔄 Transposed View
The matrix supports a transposed view that swaps rows and columns:
|
View |
Rows |
Columns |
|---|---|---|
|
Normal |
Engineering Items and Equipment Modules |
Steps (phases) |
|
Transposed |
Steps (phases) |
Engineering Items and Equipment Modules |
Toggle between views using the Transposed button in the toolbar.
Note: Row grouping (by type) is only available in the normal (non-transposed) view.
📋 Paste Preview
When you paste state data from the clipboard, the matrix enters a paste preview mode:
-
Cells that will be affected by the paste are highlighted in Gold
-
You can review exactly which cells will change before committing
-
Confirm the paste to apply, or cancel to discard
🔄 Live Updates
The Valve Phase Matrix is a live viewer that automatically refreshes when any of these events occur:
|
Event |
Matrix Response |
|---|---|
|
Active process changed |
Full matrix rebuild |
|
Active step changed |
Column highlight updates, filter recalculation |
|
Process created or updated |
Full matrix rebuild |
|
Step created, deleted, renamed, or reordered |
Column structure update |
|
Engineering Item state changed |
Cell content and highlight update |
|
Module deactivated |
Matrix window hides |
All settings (filters, highlights, transpose state, nicknames) are persisted and automatically restored when you reopen the matrix.
📁 Row Grouping
In the normal (non-transposed) view, rows can be grouped by type:
-
Engineering Items are grouped by their type classification
-
Equipment Module rows appear in their own group with the pale yellow background
-
Groups are collapsible for managing large matrices
📋 How To: Use the Valve Phase Matrix for Process Review
Step 1 — Open the Matrix
Navigate to the Module Ribbon → Live Edit panel → Matrix button.
Step 2 — Select the process to review
Ensure the correct Process is active.
Step 3 — Enable highlighting
Turn on both Highlight Fluid Allowing (green) and Highlight Changing (orange) toggles.
Step 4 — Review step-by-step transitions
Click through each step column header to make it the active step.
Step 5 — Check fluid-allowing consistency
With the Highlight Fluid Allowing toggle enabled, scan across each row to verify fluid paths are correct.
Step 6 — Verify Equipment Module configurations
Scroll to the Equipment Module rows (pale yellow background).
Step 7 — Use the type filter for focused review
Use the Type Filter dropdown to review one type at a time.
Step 8 — Export or document findings
Use the matrix as a reference during design reviews.
Tip: Combine the matrix review with the SFC Editor (GRAFCET) to see both the Engineering Item states and the transition logic simultaneously.
📚 Related Pages
-
Module Ribbon — Access the Matrix from the Live Edit panel
-
Process Design — Process and step management
-
Engineering Item — Engineering Item data model
-
State — State definitions and custom values
-
Equipment Module — Equipment Module management
-
Fluidstream Simulations — Fluid flow analysis that powers the "fluid allowing" highlights
-
SFC Editor (GRAFCET) — Complementary graphical view of step transitions
-
Symbol Editor — Symbol definition editor