Skip to main content
Help improve PyPI by participating in a 5-minute user interface survey!

Mask generation tool

Project Description

Linux/OS: [![Build Status](]( Windows: [![Build status](]( Documentation: [![Documentation Status](](

# PICwriter README Picwriter (Photonic-Integrated-Circuit Writer) is a Python module, built above the [gdspy]( module, aimed at simplifying the process of designing complex masks for photonic integrated circuits through a prebuilt library of easy-to-implement PCells (technically all sub-classes of the gdspy Cell class). Supported blocks currently include: waveguides, straight grating couplers, focusing grating couplers, tapers, spiral structures, 1x2 multi-mode interferometers, 2x2 Multi-mode interferometers (MMI’s), ring resonators, and disk resonators. More are coming soon!

## Features The ultimate goal of this module is to reduce the time required to generate photonic integrated circuit mask designs, by extending the functionality of the gdspy library. * High-level specification of common building blocks for photonic-integrated circuits * Fabrication specific masks. Specify the photoresist type (‘+’ or ‘-‘) and fabrication type (such as ‘ETCH’) and PICwriter will generate the appropriate mask files for electron-beam or photolithography. * All library components are subclasses of the gdspy Cell class, so gdspy Cell features such as rotation(), copy(), flatten(), get_bounding_box(), etc. are all supported. * Unique cell identifiers. Add components to your mask layout without worrying about name-clashes.

## Installation

### Dependencies: With a working version of python, all dependencies should be automatically installed through the instructions below.

### Linux / OS X Both options should automatically install all dependencies (like gdspy, numpy, etc.). This module is in the early planning stage, so stay tuned for the actual release :)

Option 1: using [pip](

`sh pip install picwriter `

Option 2: download the source from [github]( and build/install with:

`sh python install `

### Windows

The best way of obtaining the library is by installing the prebuilt binaries.

  • First, go to the [gdspy appveyor project page](, then click the python environment that matches your python version and processor type. For example, if you have a 64-bit processor with Python version 3.5 (you can check by running python –version in a command prompt) then you would click ‘PYTHON=C:Python35-x64’. Then, click the Artifacts tab and download the corresponding distgdspy-1.X.X.X.whl wheel file.
  • Open up a command prompt (type cmd in the search bar), navigate to your downloads, then install via:

`sh pip install dist\gdspy-1.X.X.X.whl `

  • Next, install the PICwriter library by following the same procedure as before at the [picwriter appveyor page]( to install the corresponding prebuilt picwriter .whl file.
  • In a command prompt, navigate to your downloads and install with pip:

`sh pip install dist\picwriter-1.X.X.X.whl `

Building from source is also possible. For installing gdspy, an appropriate build environment is required for compilation of the C extension modules.

Release history Release notifications

This version
History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
picwriter-0.2-py2-none-any.whl (37.6 kB) Copy SHA256 hash SHA256 Wheel py2 Feb 14, 2018
picwriter-0.2.tar.gz (19.4 kB) Copy SHA256 hash SHA256 Source None Feb 14, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page