ECSS Structures — Micro-Vibration Analysis (space-systems/ecss/microvibration-analysis)
Use when the task is the micro-vibration (microgravity, noise, and
human-induced disturbance) analysis of a spacecraft structure under
ECSS-E-ST-32C clause 4.6.2.21 — categorizing on-board disturbance
sources, computing their harmonic content, propagating disturbance
levels through the structural transfer function, and verifying
compliance of each sensitive instrument against its micro-vibration
allowable.
Domain quick reference
- Clause 4.6.2.21 addresses micro-vibration: the low-level, broadband
vibration environment induced on a spacecraft by on-board mechanical
equipment (reaction wheels, momentum wheels, cryocoolers, pumps),
low-speed periodic actuators (solar array drives), and impulsive
devices (thruster valve operations). These disturbances propagate
through the structure and can degrade pointing accuracy, blur
optical instruments, or disrupt scientific payloads.
- Disturbance sources are categorized into three families by mechanism:
rotating (generates harmonics at integer multiples of spin
frequency), periodic-low-frequency (generates a single fundamental
or small set of harmonics at the drive rate), and impulsive (broadband
shock-like input with no dominant harmonic).
- For rotating and periodic sources, structural transmissibility governs
how much of the source amplitude reaches the sensitive equipment.
Below the isolation-system natural frequency the structure transmits
essentially at unity gain; above that frequency the transmissibility
rolls off approximately as (f_isolation / f)^2 for a second-order
passive isolation system.
- A harmonic is in the sensitive band of an instrument if its frequency
falls between the instrument's lower and upper susceptibility
frequency limits. Only in-band harmonics contribute to the compliance
check; out-of-band harmonics are dropped from the amplitude
assessment for that instrument.
- Compliance at equipment is verified by comparing the peak in-band
induced amplitude (source amplitude multiplied by worst-case
transmissibility at the harmonic frequency) against the instrument
micro-vibration allowable. An instrument with in-band harmonics but
no allowable on record is itself a finding — the requirement was never
captured.
Workflow
- Inventory every on-board disturbance source and categorize each as
rotating, periodic-low-frequency, or impulsive. Reject an
unrecognized source type before it enters the assessment.
- For each rotating source, compute the harmonic frequency series:
f_n = n × f_spin for each harmonic order defined for that source
type. For periodic-low-frequency sources use the drive frequency
directly as the fundamental. Impulsive sources carry no harmonic
list; flag them for broadband review separately.
- For each (source, sensitive-instrument) pair, check whether any
harmonic falls within the instrument's susceptibility band
[f_low, f_high]. Pairs with no in-band harmonic make no contribution
to that instrument's amplitude budget; drop them from further
computation.
- For each in-band harmonic, compute the structural transmissibility
T(f) = 1.0 when f ≤ f_isolation, T(f) = (f_isolation / f)^2 when
f > f_isolation, where f_isolation is the natural frequency of the
isolation system between source and instrument. Apply T(f) to the
source harmonic amplitude to obtain the induced amplitude at the
instrument.
- Take the worst-case (maximum) induced amplitude over all in-band
harmonics of all reaching sources for each instrument.
- Compare the worst-case induced amplitude against the instrument's
micro-vibration allowable. Flag an exceedance. Separately flag an
instrument with in-band sources but no allowable on record.
- Aggregate findings per instrument; an instrument is compliant only
when no exceedance and no missing-allowable finding is present.
Pitfalls
- Computing transmissibility once at the spin frequency rather than at
each harmonic — higher harmonics push into the isolation roll-off
region and may be the critical driver, while lower harmonics remain
in the rigid-body unity-gain region.
- Treating all in-band harmonics as equally driven — harmonic amplitude
typically decreases with harmonic order; use per-order amplitude
data from the source characterization rather than copying the
fundamental amplitude to every harmonic.
- Assuming transmissibility equals unity across all frequencies because
no isolation system is installed — structural stiffness still sets an
effective transmissibility profile; unity is a conservative but valid
bound only when no structural model is available.
- Counting an impulsive source as compliant because it has no harmonic
frequency and therefore zero overlap with the sensitive band — an
impulsive source requires a separate broadband amplitude assessment
outside the harmonic framework; this leaf's harmonic check is not
sufficient to clear an impulsive source.
- Leaving a sensitive instrument's micro-vibration allowable unset and
reading "no exceedance" as compliant — an unset allowable means the
interface requirement was never established, which is itself a finding.
Behavior contract (gate 3)
The source-categorization, harmonic-frequency, transmissibility,
frequency-overlap, induced-amplitude, and compliance logic is exercised
by the gate 3 contract test: scripts/test_microvibration_analysis.py
against scripts/microvibration_analysis_logic.py (stdlib unittest,
offline). Run:
python3 scripts/test_microvibration_analysis.py
Compliance
- ECSS standards are freely downloadable (ESA); cite the source and
paraphrase per standards-map.yaml.
- compliance: STANDARDS-REF, gated: false.
1---2name: microvibration-analysis3description: "Use when determine the micro-vibration environment of a spacecraft structure under ECSS-E-ST-32C clause 4.6.2.21: categorize each disturbance source as rotating (reaction wheels, momentum wheels, cryocoolers, pumps), periodic-low-frequency (solar array drives), or impulsive (thruster valves), compute harmonic frequencies for each rotating source, apply the structural transmissibility from source mounting to sensitive equipment, check whether any harmonic falls within the instrument sensitive frequency band, compute the induced micro-vibration amplitude at equipment, and verify compliance against the instrument micro-vibration allowable. Trigger: ecss, e-st-32-structures-scope, microvibration, micro-vibration, reaction-wheel, disturbance-source, transmissibility, sensitive-instrument, jitter, harmonic."4license: Apache-2.05compliance: STANDARDS-REF6standards:7 - id: ecss8 reference-only: true9gated: false10domain: space-systems11pack: space-systems12compatibility: "agentskills.io SKILL.md; any SKILL.md host (Claude Code, Hermes, OpenClaw)"13metadata:14 source: https://skillmd.com/skills/ashfordeou/microvibration-analysis15 domain: space-systems16 subdomain: ecss17 tags: [ecss, e-st-32-structures-scope, microvibration, micro-vibration, reaction-wheel, disturbance-source, transmissibility, jitter, harmonic]18 version: 0.1.019 author: Aero Agent Skills20---2122# ECSS Structures — Micro-Vibration Analysis (space-systems/ecss/microvibration-analysis)2324Use when the task is the micro-vibration (microgravity, noise, and25human-induced disturbance) analysis of a spacecraft structure under26ECSS-E-ST-32C clause 4.6.2.21 — categorizing on-board disturbance27sources, computing their harmonic content, propagating disturbance28levels through the structural transfer function, and verifying29compliance of each sensitive instrument against its micro-vibration30allowable.3132## Domain quick reference3334- Clause 4.6.2.21 addresses micro-vibration: the low-level, broadband35 vibration environment induced on a spacecraft by on-board mechanical36 equipment (reaction wheels, momentum wheels, cryocoolers, pumps),37 low-speed periodic actuators (solar array drives), and impulsive38 devices (thruster valve operations). These disturbances propagate39 through the structure and can degrade pointing accuracy, blur40 optical instruments, or disrupt scientific payloads.41- Disturbance sources are categorized into three families by mechanism:42 rotating (generates harmonics at integer multiples of spin43 frequency), periodic-low-frequency (generates a single fundamental44 or small set of harmonics at the drive rate), and impulsive (broadband45 shock-like input with no dominant harmonic).46- For rotating and periodic sources, structural transmissibility governs47 how much of the source amplitude reaches the sensitive equipment.48 Below the isolation-system natural frequency the structure transmits49 essentially at unity gain; above that frequency the transmissibility50 rolls off approximately as (f_isolation / f)^2 for a second-order51 passive isolation system.52- A harmonic is in the sensitive band of an instrument if its frequency53 falls between the instrument's lower and upper susceptibility54 frequency limits. Only in-band harmonics contribute to the compliance55 check; out-of-band harmonics are dropped from the amplitude56 assessment for that instrument.57- Compliance at equipment is verified by comparing the peak in-band58 induced amplitude (source amplitude multiplied by worst-case59 transmissibility at the harmonic frequency) against the instrument60 micro-vibration allowable. An instrument with in-band harmonics but61 no allowable on record is itself a finding — the requirement was never62 captured.6364## Workflow65661. Inventory every on-board disturbance source and categorize each as67 rotating, periodic-low-frequency, or impulsive. Reject an68 unrecognized source type before it enters the assessment.692. For each rotating source, compute the harmonic frequency series:70 f_n = n × f_spin for each harmonic order defined for that source71 type. For periodic-low-frequency sources use the drive frequency72 directly as the fundamental. Impulsive sources carry no harmonic73 list; flag them for broadband review separately.743. For each (source, sensitive-instrument) pair, check whether any75 harmonic falls within the instrument's susceptibility band76 [f_low, f_high]. Pairs with no in-band harmonic make no contribution77 to that instrument's amplitude budget; drop them from further78 computation.794. For each in-band harmonic, compute the structural transmissibility80 T(f) = 1.0 when f ≤ f_isolation, T(f) = (f_isolation / f)^2 when81 f > f_isolation, where f_isolation is the natural frequency of the82 isolation system between source and instrument. Apply T(f) to the83 source harmonic amplitude to obtain the induced amplitude at the84 instrument.855. Take the worst-case (maximum) induced amplitude over all in-band86 harmonics of all reaching sources for each instrument.876. Compare the worst-case induced amplitude against the instrument's88 micro-vibration allowable. Flag an exceedance. Separately flag an89 instrument with in-band sources but no allowable on record.907. Aggregate findings per instrument; an instrument is compliant only91 when no exceedance and no missing-allowable finding is present.9293## Pitfalls9495- Computing transmissibility once at the spin frequency rather than at96 each harmonic — higher harmonics push into the isolation roll-off97 region and may be the critical driver, while lower harmonics remain98 in the rigid-body unity-gain region.99- Treating all in-band harmonics as equally driven — harmonic amplitude100 typically decreases with harmonic order; use per-order amplitude101 data from the source characterization rather than copying the102 fundamental amplitude to every harmonic.103- Assuming transmissibility equals unity across all frequencies because104 no isolation system is installed — structural stiffness still sets an105 effective transmissibility profile; unity is a conservative but valid106 bound only when no structural model is available.107- Counting an impulsive source as compliant because it has no harmonic108 frequency and therefore zero overlap with the sensitive band — an109 impulsive source requires a separate broadband amplitude assessment110 outside the harmonic framework; this leaf's harmonic check is not111 sufficient to clear an impulsive source.112- Leaving a sensitive instrument's micro-vibration allowable unset and113 reading "no exceedance" as compliant — an unset allowable means the114 interface requirement was never established, which is itself a finding.115116## Behavior contract (gate 3)117118The source-categorization, harmonic-frequency, transmissibility,119frequency-overlap, induced-amplitude, and compliance logic is exercised120by the gate 3 contract test: scripts/test_microvibration_analysis.py121against scripts/microvibration_analysis_logic.py (stdlib unittest,122offline). Run:123python3 scripts/test_microvibration_analysis.py124125## Compliance126127- ECSS standards are freely downloadable (ESA); cite the source and128 paraphrase per standards-map.yaml.129- compliance: STANDARDS-REF, gated: false.