Waveguide modes#

Choose a mode model from the guide geometry and the field information the calculation needs. The table links each family to its equations, construction, assumptions and validity limits. Start with the practical workflows for capillaries or solid fibres, and use running a simulation to choose an entry point.

A mode here is an object that supplies a complex effective index \(n_{\rm eff}(\omega)\) (its real part the dispersion, its imaginary part the loss), the analytic frequency derivative of that index, an effective area, and, for multimode runs, a transverse field profile. Every class in the table lives in solprop.modes.

model	class	use it for	run it with	section
Marcatili capillary	`MarcatiliMode`	gas-filled hollow capillaries: HE, TE and TM modes, tapers, pressure gradients, mixtures	`prop_capillary`	the Marcatili model
coherent wall	`CoherentWall`	a multimode capillary whose wall couples the modes, straight or tapered; separate TE and TM wall impedances	`prop_capillary(..., wall=...)`	the coherent wall
antiresonant tube lattice	`VincettiMode`	single-ring antiresonant hollow-core fibres: loss and dispersion from published fits	`prop_capillary(..., lattice=...)`	the Vincetti model
tabulated index	`IndexTable`, `TabulatedHollowMode`, `TabulatedMode`	measured or separately computed \(n_{\rm eff}(\omega)\): an evacuated hollow guide filled with gas, a filled guide as a whole, or a solid-core fibre	`prop_capillary(modes=[...])`, `prop_gnlse(fibre=...)`	tabulated data
step-index fibre	`StepIndexMode`	solid-core fibres and nanowires, exact vector modes	`prop_gnlse(fibre=...)`; several modes on the general modal route	step-index fibres
hollow rectangle	`RectMode`	hollow rectangular guides with dielectric or metal walls	`prop_waveguide`	rectangular guides
hollow planar (slab)	`SlabMode`, `PlanarGrid`	planar compressors: per unit width when uniform in y, or with the y direction resolved	`prop_waveguide`, `prop_planar`	planar guides
full vector fields	`StepIndexMode.electromagnetic_field`, `ModalGuide`	several solid-guide modes with their E and H fields, on the general modal route	`prop_waveguide(..., provider=guide)`	full fields
radial graded index	`GradedIndexProvider`	graded-index fibres: TE₀ₘ, TM₀ₘ or weak-guidance LP sectors	`prop_waveguide(..., provider=guide)`	graded-index providers

The capillary model establishes conventions that the Vincetti, tabulated-hollow, rectangular and slab models share. These models share its gas fill, its loss policy (loss=True, False, a scale or a callable), its way of forming \(n_{\rm eff}-1\) and its analytic derivatives. Each model chapter explains its additional assumptions and differences. Every way solprop represents the transverse field, these modes among them, is set side by side with its figure and its validity in spatial decompositions. Where solprop’s choices for these models differ from Luna.jl’s, the differences are listed in Noteworthy differences from Luna.

Polarised propagation uses either orthogonal mode rows or a two-component state with a shared scalar spatial profile. See polarisation and azimuthal modes for a worked input example, component inference, normalisation and selection rules.

Orthogonal mode rows                 Shared spatial profile
state: (2 modes, 1 pol, omega)        state: (1 mode, 2 pol, omega)
     | synthesis resolves x,y             | scalar synthesis on each pol
     +-------------------------+----------+
                               |
                     physical Ex, Ey at nodes
                               |
                  vector Kerr / magnitude-based plasma
                               |
                   projection back to each state layout