The Valve Phase Matrix provides a comprehensive grid view of all valve 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 (Engineering Item (Valves), Equipment Modules)
-
Columns represent steps (phases) in the active Process
-
Cells show the assigned State for each valve 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 |
|---|---|---|
|
Valve state |
Valve row |
The state name assigned to the valve in that step (e.g., "Open", "Closed", custom states). 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 valve 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 valve allows fluid to pass through in this step |
"Highlight Fluid Allowing" is ON and the valve passes fluid |
|
4 |
Orange |
State changing — The valve 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 Valve Matrix
This example shows how the Valve Phase Matrix looks for a typical CIP (Clean-In-Place) process with 10 valves across 6 phases. This is a common view when reviewing or configuring a CIP recipe in pharmaceutical manufacturing.
📋 Process: CIP Skid — Tank TK-101
Phases: Idle, Pre-Rinse, Caustic Wash, Intermediate Rinse, Acid Wash, Final Rinse
|
Valve / 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 valves 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 valves that change in each phase transition. This is invaluable during CIP recipe review to confirm that only the intended valves are actuated at each step.
🔦 Highlighting Options
Two toggle buttons in the matrix toolbar control which highlights are visible:
|
Toggle |
Effect |
|---|---|
|
Highlight Fluid Allowing |
When ON, cells where the valve allows fluid flow are highlighted in Light Green (or Yellow-Green if also changing) |
|
Highlight Changing Valves |
When ON, cells where the valve 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:
|
State Category |
Default Nickname |
Customizable |
|---|---|---|
|
Open |
Configurable |
Yes |
|
Closed |
Configurable |
Yes |
|
Generate |
Configurable |
Yes |
|
Transform |
Configurable |
Yes |
|
Unknown |
Configurable |
Yes |
📐 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 valves that have no state assigned in any step of the current process |
|
Hide In Equipment |
Hides valves that belong to an Equipment Module |
|
Hide Not In Equipment |
Hides valves 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. They filter rows based on their behavior in the currently active step:
|
Filter |
Shows Only |
|---|---|
|
Filter Open in Active Phase |
Valves that are in a fluid-allowing state in the active step |
|
Filter Closed in Active Phase |
Valves that are in a fluid-denying state in the active step |
|
Filter Changing from Previous |
Valves whose state changed compared to the previous step |
🔎 Search and Type Filters
|
Filter |
Description |
|---|---|
|
Search Text |
Free-text search that matches against valve tags and names (case-insensitive) |
|
Type Filter |
Multi-select dropdown to show/hide specific valve types (e.g., Gate Valve, Ball Valve, Butterfly Valve) |
🔄 Transposed View
The matrix supports a transposed view that swaps rows and columns:
|
View |
Rows |
Columns |
|---|---|---|
|
Normal |
Valves and Equipment Modules |
Steps (phases) |
|
Transposed |
Steps (phases) |
Valves and Equipment Modules |
Toggle between views using the Transposed button in the toolbar.
When to use transposed view:
-
When you have many steps but few valves, transposed view gives a better aspect ratio
-
When you want to compare how different valves behave in each step
-
When grouping by step order is more intuitive for your analysis
Note: Row grouping (by valve type) is only available in the normal (non-transposed) view.
📋 Paste Preview
When you paste valve 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
This prevents accidental overwrites and gives you full control over bulk state assignments.
🔄 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 |
|
Valve 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:
-
Valves are grouped by their valve class (e.g., "Gate Valve", "Ball Valve", "Pneumatic Valve")
-
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
Follow this workflow to review and validate valve states across a complete process using the matrix.
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. The matrix will load all steps (columns) and all valves/equipment modules (rows) for that process.
Step 3 — Enable highlighting
Turn on both Highlight Fluid Allowing (green) and Highlight Changing Valves (orange) toggles. This gives you immediate visual feedback on which valves are active and which are changing at each step transition.
Step 4 — Review step-by-step transitions
Click through each step column header to make it the active step. For each transition, use the "Filter Changing from Previous" filter to see only the valves that change. Verify that:
-
Only the intended valves change state at each transition
-
No unexpected valves are being actuated
-
Block valves and isolation valves remain in their required positions
Step 5 — Check fluid-allowing consistency
With the Highlight Fluid Allowing toggle enabled, scan across each row to verify fluid paths are correct:
-
Inlet and outlet valves should be open during active processing steps
-
Chemical dosing valves should only be open during their specific wash phases
-
Product isolation valves should remain closed during CIP
Step 6 — Verify Equipment Module configurations
Scroll to the Equipment Module rows (pale yellow background). Confirm that each Equipment Module has the correct configuration for each step (e.g., pump running during active phases, idle during drain).
Step 7 — Use the type filter for focused review
If your process has many valves, use the Type Filter dropdown to review one valve class at a time (e.g., review all butterfly valves, then all ball valves, then all diaphragm valves).
Step 8 — Export or document findings
Use the matrix as a reference during design reviews. The transposed view can be useful for presenting the matrix in documents where step-by-step progression is the primary axis.
Tip: Combine the matrix review with the SFC Editor (GRAFCET) to see both the valve states and the transition logic simultaneously. The SFC shows when transitions happen; the matrix shows what changes at each transition.
📚 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 Modules — Equipment Module management
-
Engineering Item (Valves) — Valve configuration
-
Fluid Stream Visualization — Fluid flow analysis that powers the "fluid allowing" highlights
-
SFC Editor (GRAFCET) — Complementary graphical view of step transitions
-
Symbol Editor — Symbol definition editor