AseptSoft Core Documentation
Breadcrumbs

Valve Phase Matrix

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 RibbonLive Edit panel → Matrix button.


🔎 Overview

The matrix displays a grid where:

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:

  1. Cells that will be affected by the paste are highlighted in Gold

  2. You can review exactly which cells will change before committing

  3. 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 RibbonLive 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.