========================================================================
SUPPLEMENTARY MATERIAL: PYTHON CODE FOR NUMERICAL SIMULATION
Manuscript Title: Mount Selection Strategy: Ensuring Compliance for Noise and Vibration in Shipboard Critical Machinery
========================================================================

1. OVERVIEW
-----------
This repository contains the standalone Python implementation used to evaluate 
the force transmissibility and Structure-Borne Noise (SBN) characteristics 
of a two-stage raft isolation system. 

The code models the multi-body dynamic interactions between:
- The primary machinery source (Engine Mass)
- The intermediate isolation platform (Raft Mass)
- Frequency-dependent dynamic stiffness properties of upper and lower mounts
- Real-world frequency-dependent ship structural mechanical impedance 
  (under varying structural stiffness configurations)

The script computes the systemic transfer function (TF) from 1 Hz to 1 kHz, 
performs parametric evaluations for different mounting setups, and outputs 
the final SBN levels at the ship structure mapped across standard 1/3-octave 
band center frequencies.

2. FILE CONTENTS
----------------
- Mount_Selection_transmissibility_analysis.py  : Main Python source code execution file.
- README.txt                         : This file (system prerequisites and description).

3. PREREQUISITES & DEPENDENCIES
--------------------------------
To run this simulation framework, you need Python 3.x along with the following 
standard computational libraries:

- NumPy (>= 1.20)      : For vector operations and numerical data arrays.
- SciPy (>= 1.6)       : For linear 1D interpolation routines (interp1d).
- Matplotlib (>= 3.3)  : For plotting frequency response and SBN curves.

You can install these dependencies via pip if they are not already installed:
$ pip install numpy scipy matplotlib

4. RUNNING THE SIMULATION
-------------------------
Execute the main script from your command line interface or any standard Python 
IDE (e.g., Spyder, PyCharm, Jupyter):

$ python raft_transmissibility_analysis.py

5. OUTPUT GENERATED
-------------------
Upon execution, the script yields interactive figures displaying:
1. Base Case Force Transmissibility (Constant lower mount properties).
2. Comparative analysis showing the effect of variable ship deck mechanical impedance.
3. Parametric sweeps varying upper mount stiffness values (Ku).
4. Parametric sweeps varying lower mount stiffness values (Kl).
5. Comparison between empirical, frequency-dependent measured mount parameters vs. idealized assumptions.
6. A definitive 1/3-octave band analysis translating Engine Feet source levels directly to Ship Structure SBN levels.

========================================================================