circular_spiral¶
- photonforge.parametric.circular_spiral(*, port_spec=None, turns=None, radius=None, separation=None, full_length=None, align_ports=False, active_model=None, technology=None, name=None, tidy3d_model_kwargs=None, waveguide_model_kwargs=None)¶
Circular spiral.
- Parameters:
port_spec (str | PortSpec) – Port specification describing waveguide cross-section.
turns (float) – Number of turns in each of the 2 spiral arms. Does not need to be an integer.
radius (float) – Bend radius for the internal spiral turns.
separation (float) – Distance between waveguide centers in parallel sections. If
None
, defaults to the port width.full_length (float) – Desired spiral length. If set to a positive value, ‘turns’ is calculated automatically.
align_ports (bool) – Optionally align ports on the same side of the spiral.
active_model (Literal['Tidy3D', 'Waveguide']) – Name of the model to be used by default; must be either
"Tidy3D"
or"Waveguide"
(default).technology (Technology) – Component technology. If
None
, the default technology is used.name (str) – Component name.
tidy3d_model_kwargs (dict[str, Any]) – Dictionary of keyword arguments passed to the component’s
photonforge.Tidy3DModel
.waveguide_model_kwargs (dict[str, Any]) – Dictionary of keyword arguments passed to the component’s
photonforge.WaveguideModel
.
- Returns:
Component with the spiral section, ports and model.
- Return type:
Note
The full length of the spiral can be computed with the
photonforge.route_length()
function.
component1 = circular_spiral(port_spec="Strip", radius=5, turns=1.25)
# Aligned ports
component2 = circular_spiral(port_spec="Strip", radius=5, turns=3, align_ports=True)