Python reader for OASIS format

Go to file

Jan Petykiewicz 3627b63658 Make records store their associated Property records. Previously, `Property` records were (incorrectly) just associated with the library or cell. This requires a change to how `CellName`s are handled by `OasisLayout`, since they can have associated properties. They now have their own non-record object (like `XName`s did before) which holds the properties. There is also now a `FileModals.property_target` attribute which tracks which record new `Property` rescords should be associated with.		2020-09-10 20:03:01 -07:00
fatamorgana	Make records store their associated Property records.	2020-09-10 20:03:01 -07:00
.gitignore	add `docs` to gitignore	2020-07-03 13:27:57 -07:00
LICENSE.md	initial commit	2017-09-18 03:01:48 -07:00
MANIFEST.in	Use fatamorgana/VERSION file to single-source version number	2019-09-28 11:22:27 -07:00
README.md	Some minor docstring/readme updates	2020-04-17 13:51:43 -07:00
setup.py	drop OS tags from package	2020-07-03 13:22:29 -07:00

README.md

fatamorgana

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

Homepage: https://mpxd.net/code/jan/fatamorgana

Capabilities:

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

Installation

Dependencies:

python 3.5 or newer
(optional) numpy

Install with pip from PyPi (preferred):

pip3 install fatamorgana

Install directly from git repository:

pip3 install git+https://mpxd.net/code/jan/fatamorgana.git@release

Documentation

Most functions and classes are documented inline.

To read the inline help,

import fatamorgana
help(fatamorgana.OasisLayout)

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

Examples

Read an OASIS file and write it back out:

    import fatamorgana

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

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