AseptSoft Core Documentation
Breadcrumbs

State

A State defines a named condition that an Engineering Item (valve, pump, instrument, etc.) can be in. Each state carries a color for visual representation on the P&ID and a fluid response that determines how it affects fluid flow.

πŸ’‘ In pharmaceutical terms: States are how you tell AseptSoft what position each valve is in during a given process step. For example, during a CIP rinse, your inlet valve might be in the "Open" state (green, allowing caustic to flow) while the product valve is "Closed" (red, blocking flow).


πŸ“‹ Properties

Property

Type

Description

Name

Text

Unique identifier for the state (e.g., "Open", "Closed", "Partial")

Color

Color

The color shown on the P&ID when this state is active

Fluid Response

Selection

How the state affects fluid flow (see table below)

Attributes

Text

Custom text attributes for additional metadata

Percentage-based

Yes/No

Whether this state supports percentage-based blending

Zero State

Reference

Reference to the "zero percent" state (only when percentage-based is enabled)

Zero Color

Color

Color shown at 0% (only when percentage-based is enabled)

Zero Fluid Response

Selection

Fluid response at 0% (only when percentage-based is enabled)

Usages

List

Valve type compatibility β€” which types of valves can use this state

Custom Attributes

Collection

User-defined attribute key-value pairs


πŸ’§ Fluid Response Types

The fluid response determines what happens to fluid flow when an Engineering Item is set to this state:

Response

What It Means

Example

Allow fluid to pass

Fluid passes through the item unchanged

Valve open β€” WFI flows through the pipe

Block fluid

Fluid is blocked β€” no flow passes through

Valve closed β€” no fluid can pass

Unknown

No fluid information β€” treated as neutral

Valve state unknown during system initialization

Change into an existing fluid stream

Fluid transforms into a specified Fluid

A heat exchanger converts water into steam

Generate a new fluid stream

A new Fluid is introduced at this point

A WFI supply source generates fresh WFI into the system

⚠️ Conflict resolution: When multiple fluid responses overlap, the system resolves them using priority: Generate > Change Into > Allow > Unknown > Block


πŸ“ Percentage-Based States

When percentage-based blending is enabled, a state supports smooth visual transitions between two appearances:

  • At 100% β€” the state uses its own Color and Fluid Response

  • At 0% β€” the state uses its Zero Color and Zero Fluid Response (or inherits from the referenced Zero State)

  • At any value in between β€” the color is blended proportionally

🏭 Pharma example: A modulating control valve (e.g., a steam regulation valve during SIP) might be at 65% open. The P&ID shows a blended color between the "Open" color and the "Closed" color to visually represent the partial position.

How the Zero State Works

The Zero State reference points to another State whose color is used as the 0% baseline color. If a separate Zero Color is also defined on this state, the system uses it as a fallback if the referenced state is not found.

The fluid response at any percentage is determined by comparing the two responses (current state and zero state) and using the higher-priority response.


πŸ”§ Usages (Valve Type Compatibility)

The Usages property defines which valve types are compatible with this state. A state can be assigned to multiple valve types. When assigning states to Engineering Items, only compatible states appear based on the item's valve type.

πŸ’‘ Tip: If a state should apply to all valve types in your module, make sure to add each valve type to the Usages list. If you forget one, that valve type will not see this state in the selection list.


πŸ“– How To: Create and Assign States

  1. Open Module Data β€” Navigate to the Data panel in the Module Ribbon and open the Module Data window.

  2. Go to the States tab β€” Select the States section.

  3. Create a new State β€” Click "Create new" and give it a descriptive name (e.g., "Open", "Closed", "CIP Drain").

  4. Set the color β€” Choose a color that will make this state visually distinct on the P&ID.

  5. Choose the fluid response β€” Select the appropriate behavior:

    • "Allow fluid to pass" for open valves

    • "Block fluid" for closed valves

    • "Generate a new fluid stream" for fluid sources

    • "Change into an existing fluid stream" for transformation points

  6. Set valve type compatibility β€” In the Usages section, select which valve types this state applies to.

  7. Enable percentage-based blending (optional) β€” If this is a modulating state, enable the percentage option and set the zero state reference.

  8. Use it in Process Design β€” Assign this state to valves in your Process Steps.


🏭 Example: CIP Module States

Below is a typical set of states for a pharmaceutical CIP (Cleaning in Place) module:

State Name

Color

Fluid Response

Percentage-Based

Compatible Valve Types

Open

Green

Allow fluid to pass

No

Ball Valve, Butterfly Valve, Diaphragm Valve

Closed

Red

Block fluid

No

Ball Valve, Butterfly Valve, Diaphragm Valve

Partial

Yellow

Allow fluid to pass

Yes (Zero = Closed)

Butterfly Valve, Control Valve

WFI Source

Blue

Generate β†’ WFI

No

Source

CIP Caustic Source

Purple

Generate β†’ CIP Caustic

No

Source

Steam Source

Gray

Generate β†’ Steam

No

Source

Drain Open

Orange

Allow fluid to pass

No

Drain Valve

Transition

Amber

Unknown

No

Ball Valve, Butterfly Valve

🏭 Why "Transition"? In pharma processes, valves do not switch instantly. The "Transition" state represents the brief period while a valve is moving between positions. During this state, the fluid response is "Unknown" because the valve position is indeterminate.