ACE — Prefabricated Interior Sound Insulation Calculation Engine
1. Skill Identity and Role Positioning
| Item | Definition |
|---|
| Skill ID | ACE |
| Skill Name | acoustic-calculation-engine |
| Role | Independent complement skill—general sound insulation calculation infrastructure |
| Core Principle | Bottom-up physical model generalization; evaluation metrics and construction rules injected by each calling skill |
| Output Nature | Professional estimate, not a laboratory test value or field measurement |
ACE is not directly exposed to end users. It serves as a calculation backend invoked by three domain skills—partition walls (PW), flooring (FL), and ceilings (CL)—receiving construction parameters through standardized interfaces (IC-03/IC-08/IC-09) and returning estimation results along with risk identification.
2. Capability Boundaries
ACE Provides the Following Calculations
| ID | Capability | Physical Model | Applicable Scenario |
|---|
| C1 | Mass Law Estimation | M1 | Basic airborne sound insulation estimation for all panel constructions |
| C2 | Coincidence Effect Analysis | M2 | Coincidence dip risk identification for all thin panel constructions |
| C3 | MSM Resonance Frequency and Cavity Gain | M3 + M4 | Double panel + cavity constructions (stud partitions, acoustic ceilings) |
| C4 | Impact Sound Improvement Estimation | M5 | Floating floors, floor screeds |
| C5 | Sound Bridge/Gap Risk Assessment | M6 | Joint risk identification for all constructions |
| C6 | Sensitivity Analysis | M1-M6 | Impact trends of key parameter variations on results |
ACE Does NOT Do the Following
- Does not perform compliance judgment (e.g., "meets standard limit")—that decision is made by the calling skill based on its own A1 performance index table
- Does not replace laboratory test reports or field measurements—output is always labeled "Professional estimate"
- Does not handle constructions beyond the applicable boundary—returns "Out of model applicability range"
- Does not cover factors that cannot be modeled: flanking transmission, weak components (e.g., doors/windows), construction quality variability
- Contains no standard limit values—remains a purely technical calculation tool
3. Interface Contract Summary
ACE is invoked through three interface contracts, each a specific instantiation of the generic ACE-IN / ACE-OUT in a particular scenario:
| Contract | Invocation Direction | Scenario | Evaluation Metric |
|---|
| IC-03 | PW → ACE | Partition wall airborne sound insulation | Rw+C / Rw+Ctr / DnT,w+C |
| IC-08 | FL → ACE | Floor impact sound insulation | Ln,w / ΔL |
| IC-09 | CL → ACE | Ceiling airborne sound insulation | Rw+C / Rw+Ctr |
Generic Input Structure (ACE-IN Three-Layer Architecture)
- Invoker Identification Layer: Skill ID + Calculation type + Evaluation metric
- Construction Description Layer: Construction type + Panel layers + Cavity layers + Support/connection system + Sealing method
- Calculation Options Layer: Output detail level + Frequency range
Minimum parameter sets for each invoker are detailed in the corresponding contract in interface-contracts.md. If parameters are insufficient, ACE returns "Insufficient parameters: unable to execute valid calculation" and lists the missing fields.
Generic Output Structure (ACE-OUT)
Calculation Results
├── Sound Insulation Estimate {lower bound, upper bound, evaluation metric, confidence level}
└── Frequency Band Analysis [{center frequency, estimated sound insulation, coincidence dip flag}]
Risk Identification
├── Coincidence Effect Risk {level, frequency range, description}
├── Sound Bridge Risk Level {level, risk points, description}
├── Sealing Assessment {conclusion, basis, improvement suggestion}
└── Construction Rationality Opinion {conclusion, risk points, optimization direction}
Sensitivity Analysis (standard/detailed mode)
Key Assumptions Explanation
Applicability Boundary Statement
Out-of-Range Warning (if applicable)
4. Redline System
Complete registration information is available in redlines-registry.md §8. The following is a summary of behavioral directives.
P0 Calculation Safety Redlines (2, inviolable)
| ID | Behavioral Directive |
|---|
| ACE-R-P0-1 | Output can only be a "professional estimate." It is prohibited to represent it as a laboratory test value or field measurement. If triggered, immediately correct and prompt that a test report is required for confirmation. |
| ACE-R-P0-2 | When input exceeds the model's applicability range, do not continue to provide deterministic numeric values. Return "Out of applicability range," list missing information, and provide manual evaluation recommendations. |
P1 Calculation Method Redlines (3)
| ID | Behavioral Directive |
|---|
| ACE-R-P1-1 | Sound bridge risk must be identified: rigid connections of studs, through-penetrating components, joint defects, etc., must be included in the risk warning. Output the sound bridge risk level and improvement suggestions. |
| ACE-R-P1-2 | Sealing risk must be assessed: insufficient acoustic sealing can significantly degrade construction performance. Output a sealing assessment; do not report only the theoretical sound insulation value. |
| ACE-R-P1-3 | Do not substitute for the main skill's compliance judgment: do not determine whether standard limits are met. Only output estimation results and risk explanations. Compliance judgment is performed by the invoking skill based on A1/B2. |
P2 Parameter Recording Redlines (2)
| ID | Behavioral Directive |
|---|
| ACE-R-P2-1 | Key assumptions must be recorded: assumptions about surface density, cavity depth, filling material, connection type, sealing method, etc., must be listed. If missing, return "parameters insufficient." |
| ACE-R-P2-2 | The evaluation metric must be clearly labeled: Rw+C, Rw+Ctr, DnT,w+C, Ln,w, ΔL must not be mixed. Output must explicitly label the metric and warn that they are not directly interchangeable. |
5. Output Specifications
Accuracy Statement
| Evaluation Metric | Typical Accuracy | Description |
|---|
| Rw+C / Rw+Ctr | ±3-5 dB | Laboratory condition estimate, based on ideal construction model |
| DnT,w+C | ±5-10 dB | Field metric, additionally accounting for field variability |
| Ln,w | ±4-6 dB | Impact sound estimate, significantly affected by pad parameter variability |
Degradation Rules
| Scenario | ACE Output Behavior |
|---|
| Insufficient parameters | Returns "Insufficient parameters: unable to execute valid calculation" and lists missing fields |
| Construction beyond applicability boundary | Returns "Out of model applicability range," lists unmodelable factors and manual evaluation recommendations |
| Unsupported calculation type | Returns "Current calculation type [XX] is not within ACE's supported range" |
| Missing material parameters | Uses typical values from the standard parameter table for estimation. The assumption description notes "estimated using typical values." |
Invoker Degradation Strategy
When ACE invocation fails, the invoker uses the simplified calculation methodology retained in its own reference.md to perform a basic estimate, and labels the output as "Simplified estimate (sound insulation calculation engine temporarily unavailable)."
6. Integration with SRE
ACE's calculation flow takes standard reasoning as a prerequisite step:
Step 0: Invoke IC-10 (SRE scenario reasoning)
↓ Obtain the applicable standard set
Step 1: Determine the evaluation metric based on project type + space type
Airborne sound scenarios:
Residential party walls → DnT,w+C (GB 55038-2025 mandatory)
Hotels/hospital guest rooms → Rw+Ctr (low-frequency sensitive scenarios)
General scenarios → Rw+C
Impact sound scenarios:
Residential floor slabs → Ln,w (GB 55038-2025 mandatory)
Surface layer improvement evaluation → ΔL
Step 2: Select the calculation model combination based on the evaluation metric
Airborne sound insulation → M1 + M2 + M3/M4 + M6
Impact sound insulation → M5 + M6
Step 3: Execute step-by-step calculation → Assemble ACE-OUT
ACE does not determine the applicable standard itself—standard identification is performed by SRE. ACE only executes the corresponding calculation model after receiving the evaluation metric.