Description
Return twice spacing, half wavelength minus spacing, and resolves when spacing is at most half the wavelength.
Spatial sampling compares a signal's wavelength with measurement spacing. An ideal sampling threshold is a theoretical condition; finite coverage, phase, noise, and reconstruction method still affect what a survey can resolve.
Return twice spacing, half wavelength minus spacing, and resolves when spacing is at most half the wavelength.
When to use this tool
Use Geophysical Spatial Sampling Nyquist Margin when you need an explicit spacing or wavelength comparison.
How to use the tool and how it works
- Enter sampleSpacing, targetWavelength. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read nyquistWavelength, spacingMargin, resolves. Inspect resolves before interpreting the associated values.
Require positive sampleSpacing and targetWavelength. Return twice spacing, half wavelength minus spacing, and resolves when spacing is at most half the wavelength.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| sampleSpacing | Sample Spacing | Required. Finite number; strictly above 0. |
| targetWavelength | Target Wavelength | Required. Finite number; strictly above 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| nyquistWavelength | Nyquist Wavelength | Required. Finite number. |
| spacingMargin | Spacing Margin | Required. Finite number. |
| resolves | Whether the nominal wavelength-versus-two-spacing inequality passes; not a complete reconstruction guarantee. | Required. Boolean. |
{
"input": {
"sampleSpacing": 5,
"targetWavelength": 20
},
"output": {
"nyquistWavelength": 10,
"spacingMargin": 5,
"resolves": true
}
}Limitations and assumptions
- Lengths share units and equality passes this nominal check; two samples per wavelength do not guarantee reconstruction for every phase, field orientation, bandwidth, or sampling pattern.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Review the full acquisition and reconstruction design. Assess aliasing, finite aperture, noise, and instrument response instead of treating a single threshold as a guarantee of resolution.
References
Similar or alternative tools
- Potential Field Upward Continuation Mode Factor
Use exp(-hypot(wavenumberX,wavenumberY) × height) as factor and multiply both real and imaginary mode components by it.
- Seismic Trace RMS One Window Term
Scale by maximum absolute value, compute mean, and return root-mean-square of raw or mean-removed samples according to removeMean; an all-zero trace returns zero mean and RMS.