Introduction of GdsLibrary

Author: heitzmann

README.md

@@ -53,6 +53,8 @@ Help support Gdspy development by [donating via PayPal](https://www.paypal.com/c
 ## History of changes
 
 ### Version 1.? (?)
+* Introduction of ``GdsLibrary`` to allow user to work with multiple library simultaneously.
+* Deprecated ``GdsImport`` in favor of ``GdsLibrary``.
 * Renamed `gds_print` to `save_gds` and `GdsPrint` to `GdsWriter`.
 * Development changed to Python 3 (Python 2.6 and above supported via [python-future](http://python-future.org/)).
 * Added photonics example.

docs/Makefile

@@ -3,7 +3,7 @@
 
 # You can set these variables from the command line.
 SPHINXOPTS    =
-SPHINXBUILD   = sphinx-build2
+SPHINXBUILD   = sphinx-build
 PAPER         =
 BUILDDIR      = _build
 

docs/conf.py

@@ -1,4 +1,4 @@
-#!/usr/bin/env python2
+#!/usr/bin/env python
 # -*- coding: utf-8 -*-
 #
 # gdspy documentation build configuration file, created by
@@ -51,7 +51,7 @@
 
 # General information about the project.
 project = 'gdspy'
-copyright = '2009-2016, Lucas H. Gabrielli'
+copyright = '2009-2017, Lucas H. Gabrielli'
 author = 'Lucas H. Gabrielli'
 
 # The version info for the project you're documenting, acts as replacement for

docs/construction.rst

@@ -7,6 +7,16 @@ Main API
 Classes
 ~~~~~~~
 
+GdsLibrary
+----------
+
+.. autoclass:: gdspy.GdsLibrary
+   :members:
+   :no-undoc-members:
+   :inherited-members:
+   :show-inheritance:
+
+
 Cell
 ----
 

docs/io.rst

@@ -7,14 +7,14 @@ Import and Output
 Classes
 ~~~~~~~
 
-GdsImport
----------
+LayoutViewer
+------------
 
-.. autoclass:: gdspy.GdsImport
+.. autoclass:: gdspy.LayoutViewer
    :members:
    :no-undoc-members:
-   :inherited-members:
-   :show-inheritance:
+   :no-inherited-members:
+   :no-show-inheritance:
 
 
 GdsWriter
@@ -27,16 +27,6 @@ GdsWriter
    :show-inheritance:
 
 
-LayoutViewer
-------------
-
-.. autoclass:: gdspy.LayoutViewer
-   :members:
-   :no-undoc-members:
-   :no-inherited-members:
-   :no-show-inheritance:
-
-
 Functions
 ~~~~~~~~~
 

examples/tutorial.py

@@ -341,14 +341,15 @@ def dspiral_dt(t):
 
 # Import the file we just created, and extract the cell 'POLYGONS'. To
 # avoid naming conflict, we will rename all cells.
-gdsii = gdspy.GdsImport('tutorial.gds',
-                        rename={'POLYGONS': 'IMPORT_POLY',
-                                'PATHS': 'IMPORT_PATHS',
-                                'OPERATIONS': 'IMPORT_OPER',
-                                'SLICE': 'IMPORT_SLICE',
-                                'REFS': 'IMPORT_REFS',
-                                'TRANS': 'IMPORT_TRANS'},
-                        layers={1: 7, 2: 8, 3: 9})
+gdsii = gdspy.GdsLibrary()
+gdsii.read_gds('tutorial.gds',
+               rename={'POLYGONS': 'IMPORT_POLY',
+                       'PATHS': 'IMPORT_PATHS',
+                       'OPERATIONS': 'IMPORT_OPER',
+                       'SLICE': 'IMPORT_SLICE',
+                       'REFS': 'IMPORT_REFS',
+                       'TRANS': 'IMPORT_TRANS'},
+               layers={1: 7, 2: 8, 3: 9})
 
 # Now we extract the cells we want to actually include in our current
 # structure. Note that the referenced cells will be automatically