Python reader for OASIS format
Go to file
2020-05-19 00:51:10 -07:00
fatamorgana Docstring updates: CTrapezoid info, Polygon+Path point_list description improvement, and better description of where x and y point to 2020-05-19 00:51:10 -07:00
.gitignore add mypy_cache to gitignore 2020-05-17 17:27:11 -07:00 initial commit 2017-09-18 03:01:48 -07:00 Use fatamorgana/VERSION file to single-source version number 2019-09-28 11:22:27 -07:00 Some minor docstring/readme updates 2020-04-17 13:51:43 -07:00 trim down classifiers 2019-09-28 11:22:43 -07:00


fatamorgana is a Python package for reading and writing OASIS format layout files.



  • This package is a work-in-progress and is largely untested -- it works for the tasks I usually use it for, but I can't guarantee I've even tried the features you happen to use! Use at your own risk!
  • Interfaces and datastructures are subject to change!
  • That said the following work for me:
    • polygons
    • layer info
    • cell names
    • compressed blocks
    • basic property I/O



  • python 3.5 or newer
  • (optional) numpy

Install with pip from PyPi (preferred):

pip3 install fatamorgana

Install directly from git repository:

pip3 install git+


Most functions and classes are documented inline.

To read the inline help,

import fatamorgana

The documentation is currently very sparse and I expect to improve it whenever possible!


Read an OASIS file and write it back out:

    import fatamorgana

    with open('test.oas', 'rb') as f:
        layout =

    with open('test_write.oas', 'wb') as f: