Simphony: A Simulator for Photonic circuits
A Simulator for Photonic circuits
About this branch
Previous development branches required the component models (from which instances are created) to be instantiated first. This attempt tries to keep them as simple classes, removing the requirement to instantiate. It also tries to keep the s-parameters with the classes, without so many file i/o and parsing algorithms.
This package is still under development. It initially began as an extension to SiEPIC-Tools, but was ported here once it became large enough to be considered its own stand-alone project. There is a repository forked from lukasc-ubc/SiEPIC-Tools, SiEPIC-Tools, that integrates Simphony with SiEPIC-Tools and KLayout in order to perform photonic circuit simulations using a layout-driven design methodology.
Simphony can be installed via pip using Python 3:
pip install simphony
Please note that Python 2 is not supported. With the looming deprecation of Python 2 (January 1, 2020), no future compatability is planned.
Documentation is built on Sphinx. They can be built using the default files by navigating to the docs directory and running:
The docs are written in reST. There is a nice syntax guide with guidelines that we follow in the documentation here. The majority of the documentation is generated from python docstrings written using the NumPy documentation format.
Changelogs can be found in docs/changelog/. There is a changelog file for each released version of the software.
Simphony uses the pytest testing framework. To run all tests, simply execute
from the toplevel directory.
This package is available on PyPI and updates are regularly pushed as "minor"
or "micro" (patch) versions. Before submitting any pull requests, however, you should
ensure that a pip installation of your updated package installs and functions
properly. To test this, try installing your package locally by removing all
installed versions of Simphony (by running
pip uninstall simphony
repeatedly until no installations remain) and running the following commands
(from Simphony's toplevel directory):
python3 setup.py sdist bdist_wheel pip install dist/simphony-[VERSION].tar.gz
All contributions and new features or bug fixes should be worked on in forks or branches of the repository. Issues should be opened, and pull requests should reference and close those issues. This is good versioning and documentation practice.
Remember that all changes are to be integrated through pull requests. Development work should be done in branches or forks of the repository. Once implemented (and tested on their own), these pull requests should be merged into the "master" branch for full testing with the whole program. Each time the package is released on PyPI, the package should have a pull request opened to its corresponding release branch (release-MAJOR.MINOR.x). The hierarchy is then as follows:
- release-..x (stable branch)
- master (integration and final testing)
- feature-name (feature development and bug fixes)
Even if you are the lone developer, we follow the methodology here.
Be sure to update the version number manually before pushing each new version to PyPI. Also be sure to amend the changelog. Versions can be pushed to PyPI using the commands:
python3 setup.py sdist bdist_wheel python3 -m twine upload dist/*
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size simphony-0.2.0-py3-none-any.whl (150.3 kB)||File type Wheel||Python version py3||Upload date||Hashes View hashes|
|Filename, size simphony-0.2.0.tar.gz (144.6 kB)||File type Source||Python version None||Upload date||Hashes View hashes|