LabRPS: Created page with "{{Plugin |Name=QBlade Plugin |Description=This plugin adds the sea surface simulation functionalities of QBlade to LabRPS. |Author=Koffi Daniel |Version=1.0 |Date=21/12/2024 |Features= QBlade Methods (CE_2.0.4_a) |RPSVersion=All }} == Introduction == This plugin adds the sea surface simulation functionalities of QBlade to LabRPS. 1024px == QBlade Methods == This is the only RPS feature that..."

2025-01-25T21:58:45Z

Created page with "{{Plugin |Name=QBlade Plugin |Description=This plugin adds the sea surface simulation functionalities of QBlade to LabRPS. |Author=Koffi Daniel |Version=1.0 |Date=21/12/2024 |Features= QBlade Methods (CE_2.0.4_a) |RPSVersion=All }} == Introduction == This plugin adds the sea surface simulation functionalities of QBlade to LabRPS. 1024px == QBlade Methods == This is the only RPS feature that..."

New page

{{Plugin
|Name=QBlade Plugin
|Description=This plugin adds the sea surface simulation functionalities of QBlade to LabRPS.
|Author=Koffi Daniel
|Version=1.0
|Date=21/12/2024
|Features= [[#QBlade_Methods|QBlade Methods (CE_2.0.4_a)]]

|RPSVersion=All
}}

== Introduction ==
This plugin adds the sea surface simulation functionalities of QBlade to LabRPS.

[[Image:Plugin_SeaLab_QBladeMethods_Screenshot_1.png|1024px]]

== QBlade Methods ==
This is the only RPS feature that the plugin implements. It belongs to the [[RPS_Feature_Group#Simulation_Method| simulation method group]]. This feature allows the user to simulate sea surface as regular or irregular wave based on QBlade which is an advanced multi-physics software designed to facilitate the comprehensive aero-servo-hydro-elastic development, prototyping, simulation, and certification of wind turbines.

=== Feature Dependency ===
The features required by this feature are as follows:

* A [[RPS_Feature_Group#Location_Distribution| simulation points feature.]] May be in form of grid.
* A [[RPS_Feature_Group#Randomness| randomness provider feature]]

=== Properties ===

* {{PropertyData|TimeOffset}}: Time shift of the generated wave signal
* {{PropertyData|WaveGeneratorType}}: The wave type: 0 = Times Series From File, 1 = Components From File, 2 = Single Wave, 3 = JONSWAP, 4 = ISSC, 5 = TORSETHAUGEN, 6 = OCHI-HUBBLE
* {{PropertyData|LowCutOff}}: The minimum frequency considered in the DFT, below which wave components are discarded (approximately low-pass filtering).
* {{PropertyData|HighCutOff}}: The maximum frequency considered in the DFT, above which wave components are discarded (approximately high-pass filtering).
* {{PropertyData|SignalSamplingRate}}: The frequency with which data from the time series is sampled before the DFT is performed. This allows the user to reduce the number of wave components that will be generated by the DFT.
* {{PropertyData|AmplitudeThreshold}}: The minimum wave component amplitude allowed after the DFT is performed. This allows the user to filter out wave components with insignificant amplitude and thereby helps to reduce the number of generated wave components.
* {{PropertyData|SignificantWaveHeight}}: Height of wave train to be generated (directly linked to amplitude)
* {{PropertyData|SignificantWaveAmplitude}}: Amplitude of the wave (directly linked to wave height)
* {{PropertyData|PeakPeriod}}: Period of the wave (directly linked to wave frequency)
* {{PropertyData|PeakFrequency}}: Frequency of the wave (directly linked to the wave period)
* {{PropertyData|SpectralPeaks}}: The spectrum peak shape: 0 = Single Peak, 1 = Double Peak
* {{PropertyData|AutomaticGamma}}: Automatic or manual definition of the spectral width parameter.
* {{PropertyData|AutomaticSigma}}: Automatic or manual definition of the spectral width parameter.
* {{PropertyData|Gamma}}: Custom gamma value
* {{PropertyData|Sigma1}}: sigma1 value
* {{PropertyData|Sigma2}}: Sigma2 value
* {{PropertyData|AutomaticOchiHubbleParameters}}: Custom Ochi-Hubble Parameters are used if true
* {{PropertyData|SignificantWaveHeight1}}: The significant height 1
* {{PropertyData|SignificantWaveHeight2}}: The significant height 2
* {{PropertyData|PeakFrequency1}}: Peak frequency 1
* {{PropertyData|PeakFrequency2}}: Peak frequency 2
* {{PropertyData|PeakShape1}}: Peak shape 1
* {{PropertyData|PeakShape2}}: Peak shape 2
* {{PropertyData|DiscretizationMethod}}: Frequency Discretization: 0 = Equal Energy, 1 = Equal Frequency
* {{PropertyData|AutomaticFrequencyRange}}: Use automatic frequency range
* {{PropertyData|CutInFrequency}}: cut-in frequency
* {{PropertyData|CutOutFrequency}}: cut-out frequency
* {{PropertyData|MaximumBinWidth}}: Maximum frequency range of the spectrum discretization
* {{PropertyData|NumberOfFrequencyBins}}: Resolution of frequency discretization of the energy spectrum.
* {{PropertyData|RandomPhaseSeed,}}: The random seed assigning the wave component phase data
* {{PropertyData|Directionality}}: Either a unidirectional irregular wave (Single Dir) or multidirectional wave (Cos Spread) can be created
* {{PropertyData|PrincipalWaveDirection}}: Definition of the wave direction (unidirectional spectrum) or of the principal direction of the cosine spectrum.
* {{PropertyData|MaximumSpread}}: Definition of the width of the cosine spectrum.
* {{PropertyData|SpreadingExponent}}: Shape defining parameter for the directional spectrum
* {{PropertyData|NumberOfDirectionalBins}}: Resolution of angular discretization of the directional spectrum.
* {{PropertyData|Width}}: Grid width
* {{PropertyData|Length}}: Grid length
* {{PropertyData|WidthGridNumber}}: Number of point along the grid width
* {{PropertyData|LengthGridNumber}}: Number of point along the grid length
* {{PropertyData|WaterDepth}}: The water depth
* {{PropertyData|Gravity}}: The gravity
* {{PropertyData|RequestedVariable}}: Computed Variable (Acceleration, Velocity or Displacement)

=== Scripting ===

{{Code|code=
import LabRPS
import SeaLab
import SeaLabObjects
from LabRPS import Vector as vec
import time

def simulate():
# Plugin
installResuslt = SeaLab.installPlugin("SeaLabPlugin")
if not installResuslt:
LabRPS.Console.PrintError("The installation the QBladePlugin has failed.\n")
return None

installResuslt = SeaLab.installPlugin("QBladePlugin")
if not installResuslt:
LabRPS.Console.PrintError("The installation the AspasiaZervaPlugin has failed.\n")
return None

# Document
doc = LabRPS.newDocument()

# Simulation
sim = SeaLabObjects.makeSimulation(doc, "Simulation")
if not sim:
LabRPS.Console.PrintError("The simulation does not exist.\n")
return None

# Simulation points
loc = SeaLabObjects.makeFeature("SimulationPoints", "Simulation", "Grid Points", "Location Distribution")
if not loc:
LabRPS.Console.PrintError("Error on creating the location distribution.\n")
return None

# Random phase
randomness = SeaLabObjects.makeFeature("RandomPhases", "Simulation", "Uniform Random Phases", "Randomness Provider")
if not randomness:
LabRPS.Console.PrintError("The creation of the randomness provider was not successuful.\n")
return None

# Simulation method
simMethod = SeaLabObjects.makeFeature("SimulationMethod", "Simulation", "QBlade Methods (CE_2.0.4_a)", "Simulation Method")
if not simMethod:
LabRPS.Console.PrintError("Error on creating the simulation method.\n")
return None
sim.Stationarity = False
# Run simulation and output the first(0) sample
# store starting time
begin = time.time()
velocities = sim.simulate(0)
# store end time
end = time.time()
LabRPS.Console.PrintMessage(f"Total runtime of the simulaltion is {end - begin} seconds\n")

if LabRPS.GuiUp:
import SeaLabGui
import GeneralToolsGui
SeaLabGui.setActiveSimulation(sim)
GeneralToolsGui.GeneralToolsPyTool.showArray(sim.getSimulationData().numberOfTimeIncrements, sim.getSimulationData().numberOfSpatialPosition + 1, velocities, True)
doc.recompute()
simulate()
}}

Plugin SeaLab QBlade - Revision history