VIBTOOLBOX DOCUMENTATION

最新推荐文章于 2021-05-13 14:46:39 发布

fpxBGDBN

最新推荐文章于 2021-05-13 14:46:39 发布

阅读量4.3k

点赞数

分类专栏： C++

C++ 专栏收录该内容

129 篇文章 3 订阅

订阅专栏

http://vibtoolbox.sourceforge.net/vtbman.html#asdvsd

http://vibtoolbox.sourceforge.net/

About vibtoolbox

Vibtoolbox is a set of command line tools for analysis of vibration and acoustic test data. The interface design used for most of the tools in the package is the standard UNIX filter model. The tools take input on standard input and transform the input in some fashion, and then send the transformed input data to standard output. The tool set also defines ASCII and native binary database formats for storage of vibration and acoustic laboratory and flight test data.

Vibtoolbox was started in 2003 by Greg Rudd, out of the need to have a set of tools to handle vibration and acoustic test data in a general and portable way. An important goal of the project was that the code for the analysis tools would be self contained and easy to port and maintain on different UNIX operating systems.

System of units

The programs in this package are designed to work with SI absolute units, US absolute units, and US gravitational units. The programs do not work with the US engineering system of units that require a additional factor to be included in the relation between force and mass. Any consistent units may be used in the programs. This means that all parameters must be expressed in the same units within the program. Examples of consistent units that work in these programs are:

     ------------------------------------------------------
     System  Force        Length         Mass        Time
     ------------------------------------------------------
     SI      kilonewton   meter          kilogram    second
     SI      newton       millimeter     kilogram    second
     US      pound-force  inches         lbf-s^2/in  second
     US      pound-force  foot           slug        second
     US      poundal      foot           pound       second

Primer and example analysis

The vibtoolbox utilities are used like other standard UNIX command line utilities. Standard output from one program can be passed to standard input of an another program via UNIX pipes. Also the programs process input and output data using UNIX I/O redirection. The programs in the package use a subset of the gnuplot data format for the STDIN and STDOUT streams. The utilities handle commend line options using the getopt utility.

For example lets see how we would use the filters to analysis some flight test time history data.

Assume for the example we have the flight data stored in the vibtoolbox ASCII database format.

The ASCII data can then be packed to native binary format using:

     packdb flights channels < DATABASE > DATABASE.BIN
     
     Where:
     flights         is a list of flight conditions to process
     channels        is a list of channels to process
     DATABASE        is the input ASCII database
     DATABASE.BIN    is the output binary database

Note flight conditions and channels are input using a colon operator to

     for example:
     1,2,10:15,6 would expand to 1,2,10,11,12,13,14,15,6

To read a time record from the binary database use:

     breaddb conditions channels < DATABASE.BIN > TimeHistory
     
     Were TimeHistory contains the extracted time history in gnuplot format.

Calculate basic properties of the time history record using:

     checkth < timehistory
     
     Sample output is:
     
     #BLOCK Flight = 23 Channel = 12104
     Samples per Second =                      5998.784
     Standard Deviation Sample Rate =             0.167
     Maximum signal level =                     266.659
     Minimum signal level =                    -266.667
     Signal duration =                           60.012
     Number of samples =                         360000
     Signal standard deviation =              5.932e+01
     Signal mean =                            2.257e-01
     Crest factor =                           4.496e+00

Calculate autospectral density of the time history using:

     asd PointsPerSegment NumberOfAverages < TimeHistory > AutoSpectralDensity

Calculate autospectral density without writing out the time history to a file using:

     cat DATABASE.BIN | breaddb conditions channels | asd PointsPerSegment NumberOfAverages > AutoSpectralDensity

The vibtoolbox tools can be used with other UNIX utility's on the command line. For example to add calculation of RMS signal level to the above calculation use:

     cat DATABASE.BIN | breaddb conditions channels | asd PointsPerSegment NumberOfAverages | tee ASD.OUT | rms > RMS.OUT
     
     autospectral density is stored in file ASD.OUT using the UNIX tee command.

Vibtoolbox programs

absrs: Random response spectra from autospectral density.
aflow: Calculate attached flow autospectral density
airspeed: Calculate airspeeds and atmosphere properties.
asd: Calculate autospectral density of time history.
asdvsd: Transform acceleration autospectral density to velocity autospectral density.
autocor: Calculate auto correlation of time history.
avespec: Calculate average spectra for set of vibration spectra.
bdb2psd: Read time history from binary database and calculate autospectral density.
beamfn: Calculate resonance frequency for beam.
bmaxfc: Calculate condition and channel envelope from binary database.
breadcd: Create input file from binary database for cross spectral density or coherence analysis.
breaddb: Read time history or autospectral density data from binary database.
breakpoint: Find spectra breakpoints on log-log coordinates.
calq: Calculate damping of detected peaks in autospectral density.
cdiff: Differentiation of time history.
cfft: Calculate FFT of time history.
checkdb: Check database array size matches database array size parameter.
checkth: Calculate time history statistics.
clipth: Clip amplitude of time history
cohere: Calculate coherence of time history.
csd: Calculate cross spectral density of time history.
cspline: Cubic spline interpolation.
cumrms: Cumulative RMS for autospectral density.
cvib: Vibration test type conversions for equivlent fatigue damage.
dba: Calculate dBA sound pressure level.
dbfactor: Apply dB factor to autospectral density or sine or SPL spectra.
desample: Decimation time history.
dropout: Interpolate time history dropouts.
enddb: Calculate endurance vibration envelope.
endsdb: Endurance vibration envelope with third octave smoothing.
envel: Calculate envelope of vibration spectra.
esd: Energy spectral density of time history.
exceed: Calculate exceedances
fft: Calculate fft of time history.
fstress: Fatigue calculation using rainflow cycle count.
gain: Calculate transfer function.
gp2db: Convert gnuplot file to ASCII database.
gsine: Generate constant amplitude sine signal.
gwhite: Generate white noise with normal distribution
hann: Hanning window data
histogram: Calculate histogram.
hpf: High-pass butterworth filter
ifft: Calculates inverse FFT.
ilpa: Calculate log-log plot parameters for amplitude spectra.
ilpp: Calculate log-log plot parameters for power spectra
int: Interpolate autospectral density on log-log coordinates.
intampthird: Interpolate SPL data.
integ: Integration of time history.
intspl2octave: Interpolate SPL to octave bands
intspl2old: Interpolate SPL to old SPL bands
intspl2third: Interpolate SPL to third octave bands.
japwavebs: Joint acceptance for progressive wave on simply supported beam.
jarevps: Joint acceptance for reverberent noise on plate with simple supports.
jasflow39bs: Longitudinal Joint acceptance upstream of protuberance simple support beam per Wyle report 71-10 Equation 39.
lpf: Lowpass butterworth filter.
ltrend: Remove linear trend from time history
maxfc: Calculate flight and channel envelope.
nocal: Calculate endurance vibration envelope.
normth: Normalize time history to start at zero time
ntl: Calculate log normal tolerance limit
oaspl: Overall sound pressure level.
oct2psd: Convert octave data to autospectral density
omathdiff: Multiplies complex data in real - imag format by i*omega
omathint: Divides complex data in real - imag format by i*omega
packdb: Pack ASCII time history or autospectral density database file to binary database.
peaks: Find peaks of time history
penvel: Minimum, average, and maximum envelope of a set of vibration spectra.
platemodalmass: Calculation of modal mass for plate with simple supports.
psd2spr: Convert psd to sound pressure response
psdresponse: Autospectral density response given autospectral density input spectra.
rainflow: Rainflow cycle count.
ranpan: Random panel response to acoustic pressure
readdb: Read time history or psd data from ASCII database
readspl: Read SPL from ASCII database
relpsdresponse: Relative autospectral density response given autospectral density input spectra.
relrs: Relative response spectra given autospectral density input.
rfsetup: Arrange time history for simplified rainflow
rmean: Remove mean from time history
rms: Calculate root mean square of power spectral density
rmsoctave: RMS in octave octave bands.
rmsth: RMS time history.
rmsthird: Calculate RMS in third octave bands
rstress: Estimate standard deviation of stress in structure
scale: Calculate autospectral density in measurement units to engineering units.
scaledb: Calculate SPL in measurement units to engineering units.
sfactor: Apply scale factor.
sflow10: Calculate separated flow power spectral density
sflow43: Calculate separated flow power spectral density
shockth: Generate shock time history
sil: Calculate sil sound pressure levels.
smooth: Applies constant Q smoothing to autospectral density.
sploctave: Calculate octave band SPL from autospectral density
splthird: Calculate third octave band SPL from autospectral density
sranvib: Scale random vibration test
srsa: Calculate shock response spectra absolute acceleration response for base input.
srse: Calculate shock response spectra static equivalent acceleration response for base input.
srsf: Calculate shock response spectra for force input shock.
ssl2psd: Convert sound spectra level to autospectral density(psi**2/Hz)
third2octave: Convert third octave data to octave data
third2psd: Convert third octave data to autospectral density
thrms: Calculate time history of signal RMS level
thsplit: Split time history into segments
timer: Reverse time history on time axis
tp2: Truncates data file to power of 2.
transfun: Calculate transfer function of time history.
transloss: Transmission loss calculation
tslice: Selects time slice from time history file
unpackdb: Unpacks binary time history or autospectral density database to ASCII database.
vlist: List descriptions of programs in vibtoolbox package.
vsddsd: Transform velocity autospectral density to displacement autospectral density.
zerocross: +zero crossings from autospectral density input spectra.
zerofill: Windows and zero fills

GOTO: vibtoolbox programs

4.1 absrs

     
     This program calculates random response spectra given autospectral density
     input.  The response is calculated referenced to inertial space coordinates.
     
     USAGE: absrs [OPTIONS] STDIN STDOUT
     
     OPTIONS:
     -h prints help message
     -q number = quality factor
        default quality factor = 10
     
     STDIN:
     The input file is a free-format ASCII text file with two columns.
     
     Frequency (Hz) and autospectral density (eu^2/hz)
     
     eu is engineering unit.
     
     There may be more then one data set in the input file. Each data set is
     separated by 2 empty lines.
     
     STDOUT:
     
     The output file is a free-format ASCII text file with two columns.
     
     Frequency (hz) and RMS Response Amplitude (eu)
     
     eu is engineering unit.
     
     There may be more then one data set in the output file.  Each data set is
     separated by 2 empty lines.  This file can be processed by gnuplot.

VIBTOOLBOX DOCUMENTATION

About vibtoolbox

System of units

Primer and example analysis

Vibtoolbox programs

4.1 absrs

4.2 airspeed

4.3 asd

4.4 asdvsd

4.5 autocor

4.6 avespec

4.7 bdb2psd

4.8 beamfn

4.9 bmaxfc

4.10 breadcd

4.11 breaddb

4.12 breakpoint

4.13 calq

4.14 cdiff

4.15 cfft

4.16 checkdb

4.17 checkth

4.18 clipth

4.19 cohere

4.20 csd

4.21 cspline

4.22 cumrms

4.23 cvib

4.24 dba

4.25 dbfactor

4.26 desample

4.27 dropout

4.28 enddb

4.29 endsdb

4.30 envel

4.31 esd

4.32 exceed

4.33 fft

4.34 fstress

4.35 gain

4.36 gsine

4.37 gwhite

4.38 hann

4.39 histogram

4.40 hpf

4.41 ifft

4.42 ilpa

4.43 ilpp

4.44 int

4.45 intampthird

4.46 integ

4.47 intspl2octave

4.48 intspl2old

4.49 intspl2third

4.50 jarevps

4.51 jasflow39bs

4.52 japwavebs

4.53 lpf

4.54 ltrend

4.55 maxfc

4.56 nocal

4.57 normth

4.58 ntl

4.59 oaspl

4.60 oct2psd

4.61 omathdiff

4.62 omathint

4.63 packdb

4.64 peaks

4.65 penvel

4.66 platemodalmass

4.67 psd2spr

4.68 psdresponse

4.69 rainflow

4.70 ranpan

4.71 readdb

4.72 readspl

4.73 relpsdresponse

4.74 relrs

4.75 rfsetup