circular_spiral

photonforge.parametric.circular_spiral(*, port_spec=None, turns=None, radius=None, separation=None, full_length=None, align_ports=None, active_model=None, technology=None, name=None, tidy3d_model_kwargs=None, waveguide_model_kwargs=None)[source]

Circular spiral.

Parameters:

  • port_spec (Annotated[str | PortSpec, _] | None) – Port specification describing waveguide cross-section.

  • turns (Annotated[float, minimum=0, units='μm'] | None) – Number of turns in each of the 2 spiral arms. Does not need to be an integer.

  • radius (Annotated[float, exclusiveMinimum=0, units='μm'] | None) – Bend radius for the internal spiral turns.

  • separation (Annotated[float, minimum=0, units='μm'] | None) – Distance between waveguide centers in parallel sections. If None, defaults to the port width.

  • full_length (Annotated[float, exclusiveMinimum=0, units='μm']) – Desired spiral length. If set to a positive value, ‘turns’ is calculated automatically.

  • align_ports (Annotated[bool, _] | None) – Optionally align ports on the same side of the spiral. If None, defaults to False.

  • active_model (Annotated[Literal['Tidy3D', 'Waveguide'], _] | None) – Name of the model to be used by default; must be either "Tidy3D" or "Waveguide" (default).

  • technology (Annotated[Technology, _] | None) – Component technology. If None, the default technology is used.

  • name (Annotated[str, _] | None) – Component name.

  • tidy3d_model_kwargs (Annotated[dict[str, Any], _] | None) – Dictionary of keyword arguments passed to the component’s photonforge.Tidy3DModel.

  • waveguide_model_kwargs (Annotated[dict[str, Any], _] | None) – Dictionary of keyword arguments passed to the component’s photonforge.WaveguideModel.

Returns:

Component with the spiral section, ports and model.

Return type:

Component

Note

The full length of the spiral can be computed with the photonforge.route_length() function.

component1 = pf.parametric.circular_spiral(port_spec="Strip", radius=5, turns=1.25)

# Aligned ports
component2 = pf.parametric.circular_spiral(port_spec="Strip", radius=5, turns=3, align_ports=True)
circular_spiral