Description
Calculate north-referenced polarization azimuth and magnitude from two components.
Geophysical observations depend on acquisition geometry, sample timing, component orientation, reference levels and calibration signs. Ideal travel-time depth and one-dimensional alias bounds describe supplied models rather than a complete subsurface inversion. A referenced signal or pseudodepth label needs its original physical convention.
Calculate north-referenced polarization azimuth and magnitude from two components.
When to use this tool
Use Polarization Component Azimuth when checking the stated local geophysical geometry, reference, sampling or calibration term.
How to use the tool and how it works
- Enter northComponent, eastComponent. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read azimuthDegrees, magnitude, defined. Inspect defined before interpreting the associated values.
Compute hypot(north,east) and atan2(east,north) in degrees, adding 360 for negative angles. Return zero azimuth with defined=false only when magnitude is zero.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| northComponent | North Component | Required. Finite number. |
| eastComponent | East Component | Required. Finite number. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| azimuthDegrees | Clockwise angle from north; zero placeholder when defined=false for a zero vector. | Required. Finite number. |
| magnitude | Magnitude | Required. Finite number. |
| defined | Whether the corresponding reporting denominator/direction is defined; inspect before interpreting zero placeholders. | Required. Boolean. |
{
"input": {
"northComponent": 0,
"eastComponent": 2
},
"output": {
"azimuthDegrees": 90,
"magnitude": 2,
"defined": true
}
}Limitations and assumptions
- Azimuth is clockwise from north on supplied components; zero is a placeholder for a zero vector, not a measured direction or geographic reference validation.
- 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
Use calibrated acquisition records and an appropriate complete wavefield, geological or instrument model for physical inference and safe field operations.
References
Similar or alternative tools
- Magnetic Declination Grid North Offset
Apply supplied magnetic-to-true and true-to-grid rotations to a bearing.
- Magnetic Inclination Vector Component Tool
Magnetic north/east/down components, inclination positive downward and declination clockwise from north, all angles radians.