spode 0.0.7

A simulator with programmable photonics and differentiability emphasis

Spode is an opensource differentiable simulator specialized for programmable photonics. It is currently under active development.

Why to use Spode

Spode provides the most comprehensive functions for research, design of programmable photonics.

• Spode is a frequency-domain simulator specialized for programmable photonics.
• It supports derivative calculation of any port magnitude to any parameter.
• The built-in generator enables users easily produce triangular, square, and hexagonal mesh.
• The built-in visualization functions produce high-quality figures satisfying academic purposes.
• A few functions are available for analyze the imperfections (e.g., random variation) in programmable photonics.

Installation

Spode is written in Python 3, with dependency on Numpy. It should be installed successfully with pip:

pip install spode

A Friendly Example

from spode.util import generate
from spode.core import Circuit
import numpy as np

# generator instance for a 2 by 2 square mesh
# initialize all TBUs in the circuit

init_dict = {'theta': 0.0, 'phi': 0.0, 'l': 250e-6}
circuit_element = generate('square_1', [2, 2], init_dict)

 
# define the circuit instance and run the simulation

circuit = Circuit(
                  circuit_element=circuit_element,
                  mode_info={'neff':2.35}, # effective index
                  omega=np.linspace(192.5,193.5,1000) * 2 * np.pi, # [192.5Thz, 193.5Thz]
                  srce_node={'n_0#2_br': 1.0},
                  prob_node=['n_2#0_br'],
                  deri_node=['n_2#0_br'],
                  deri_vari=['']) 
                  
response, grads = circuit.solve() 

# Shapes by pseudo code:
# response.shape = (len(prob_node), len(omega), 2)
# grads.shape = (len(deri_node), len(deri_vari), len(omega), 2)

Tutorials

Lesson 1: a tunable basic unit. We show how to use Spode to define a tunable basic unit (TBU), the building block of programmable photonics, and verify the simulation result by comparing with Lumerical Interconnect.

Lesson 2: a 2 by 2 square mesh. We show two ways to define a 2 by2 square mesh (i.e., manually and using built-in generator), and verify the simulation result by comparing with Lumerical Interconnect.

Lesson 3: Automatic circuit generators. We illustrate a few built-in circuit generators, which could be used in one-line manner to generate triangular, square, hexagonal mesh. We also introduce a systematic way to name the TBUs, ports presented in the circuit.

Contact and Bug Report

If you find any bugs, or want a new feature, please open an issue, or contact me at [e-mail].