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. |
📋 A valve cell can show a plain manual state (such as Open or Closed) or, when an instrument is driving that valve in the step, a composed control cell that names the control state together with the controlling instrument. See Under-Control Cells below.
🤖 Under-Control Cells
When a valve is driven by an instrument in a step, its matrix cell does not show a hand-picked Open or Closed. Instead it shows a composed control cell that combines the control state name with the tag of the controlling instrument, so you can read who is driving what at a glance.
🧱 How a Control Cell Is Composed
A control cell reads as the control-state name, then a separator, then the controlling instrument's tag — optionally followed by the linked variable or parameter (the "XX source"):
|
What You See |
Meaning |
|---|---|
|
PID control ⚙ FCV-203 |
The intrinsic control valve is modulating under PID control, driven by FCV-203 |
|
Under control ⚙ PIT-501 |
The on/off valve is held under setpoint control, driven by PIT-501 |
|
PID control ⚙ FCV-203 / Setpoint |
Same as above, with the XX source (the linked variable/parameter) appended |
The two control-state names (Under control for ordinary valves, PID control for intrinsic control valves), the separator character (⚙ by default), and whether the controller tag and XX source are shown are all configurable for the environment. The full behaviour and the workflow for putting a valve under control are documented on the Control Loop page.
💡 A valve is either in a manual state or under instrument control in a given step — never both. So a control cell completely replaces the Open/Closed text for that valve in that step.
📊 Round-Trip to Excel
The composed control cell is the same identifier end to end. When you export the process to Excel, each under-control cell is written exactly as it appears in the matrix — for example PID control ⚙ FCV-203. When that file is imported again, AseptSoft reads the cell back, matches the named instrument by its tag, and restores the controlling relationship and the valve's control state automatically.
|
Direction |
What Happens |
|---|---|
|
Matrix → Excel (export) |
Each controlled valve cell is written as the composed control text, so the spreadsheet carries the full control picture, step by step |
|
Excel → Matrix (import) |
A composed cell is parsed back: the controller is found by tag, the control relationship for that step is restored, and the valve returns to its control state |
✅ Because the composed text is identical in both directions, a process reviewed and edited in Excel comes back into AseptSoft with its per-step control configuration intact — no manual re-linking.
⚠️ If an imported control cell names an instrument that does not exist in the module, the valve keeps the plain control state so the visuals stay correct, but no controller is linked until the instrument is present. Check the instrument tag spelling if a controller fails to reconnect on import.
🎨 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 |
💡 A control cell behaves like any other state for highlighting: because controlled segments keep the fluid path open, an under-control valve typically lights up as fluid-allowing, and it lights up as state-changing on the step where it enters or leaves control.
🏭 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 |
|
CV-202 (Flow Trim) |
Closed |
PID control ⚙ FIT-203 |
PID control ⚙ FIT-203 |
PID control ⚙ FIT-203 |
PID control ⚙ FIT-203 |
PID control ⚙ FIT-203 |
|
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).
-
CV-202 enters control: the flow-trim valve switches from Closed to PID control ⚙ FIT-203 at Pre-Rinse — it lights up as state-changing on that step, then holds the control cell through the rest of the cycle while FIT-203 keeps driving it.
-
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 Intermediate Rinse to Acid Wash: V-104 stays Closed; the Acid Wash dosing is trimmed by CV-202 under FIT-203, unchanged from the prior step.
-
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 control assignments
Scan for composed control cells (e.g. PID control ⚙ FIT-203) to confirm the right instrument drives the right valve in each step.
Step 7 — Verify Equipment Module configurations
Scroll to the Equipment Module rows (pale yellow background).
Step 8 — Use the type filter for focused review
Use the Type Filter dropdown to review one type at a time.
Step 9 — Export or document findings
Use the matrix as a reference during design reviews, or export to Excel — control cells carry over and import back unchanged.
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
-
Control Loop — How an instrument controls a valve per step, and the control-state display settings
-
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