Praseodymium Line Match
Match a requested wavelength to caller-supplied praseodymium fiber lines.
Description
Line matching selects the closest entry from a supplied praseodymium wavelength list.
Line matching selects the closest entry from a supplied praseodymium wavelength list. A caller tolerance determines acceptance.1
Match a requested wavelength to caller-supplied praseodymium fiber lines.
When to use Praseodymium Line Match
Use this tool to match a requested wavelength to caller-supplied praseodymium fiber lines.
Prepare the optical measurements, geometry, fitted coefficients or caller-selected thresholds requested. Confirm wavelength, radius/diameter, pulse-width, angle and unit conventions before running the calculation.
How to use Praseodymium Line Match and understand its results
- Prepare the optical measurements, geometry, fitted coefficients or caller-selected thresholds requested. Confirm wavelength, radius/diameter, pulse-width, angle and unit conventions before running the calculation.
- Enter requestedWavelengthNanometers, availableLinesNanometers, maximumDetuningNanometers using the field table and calculation rules, then run the tool.
- Read nearestLineNanometers, detuningNanometers, withinTolerance. The explanation below defines the units, signs, ordering and any flags or placeholder values.
- If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.
| Input field | Meaning | Value type; see rules below | Requirement |
|---|---|---|---|
| requestedWavelengthNanometers | Requested wavelength (nm) | number | Required |
| availableLinesNanometers | Available praseodymium lines (nm) | list of number | Required |
| maximumDetuningNanometers | Maximum detuning (nm) | number; minimum: 0 | Required |
Enter finite requested/list wavelengths, a nonempty line list and nonnegative nm tolerance. Preserve first entry on equal-distance ties. Return nearest line, detuning and flag.
nearest=argmin|line−requested|; accepted if distance≤maximum Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.
| Output field | Meaning | Value type |
|---|---|---|
| nearestLineNanometers | Nearest available line (nm) | number |
| detuningNanometers | Absolute detuning (nm) | number; minimum: 0 |
| withinTolerance | Within detuning tolerance | boolean |
{
"input": {
"requestedWavelengthNanometers": 520,
"availableLinesNanometers": [
500,
522,
600
],
"maximumDetuningNanometers": 3
},
"output": {
"nearestLineNanometers": 522,
"detuningNanometers": 2,
"withinTolerance": true
}
}Limitations and assumptions
No built-in spectral line catalog, positivity check or gain suitability is provided.
Numeric inputs must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Lists are limited to 100,000 entries; the rules above may require smaller limits. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors. A successfully returned false flag is an evaluated outcome; its meaning is explained above.
Alternative or Complementary methods
Use He–Cd Line Selector: Select the nearer common He–Cd line to a requested wavelength. For a complementary task, use Wavelength-Lock Selector: Select an absorption-cell, etalon, or hybrid wavelength lock from supplied requirements.
References
-
Praseodymium Line Match — tool.io
Similar or alternative tools
- He–Cd Line Selector
Select the nearer common He–Cd line to a requested wavelength.
- Wavelength-Lock Selector
Select an absorption-cell, etalon, or hybrid wavelength lock from supplied requirements.