gdsii.library — interface to a GDSII library

This module contains class that represents a GDSII library.

class gdsii.library.Library(version, name, physical_unit, logical_unit, mod_time=None, acc_time=None)

Bases: list

GDSII library class. This class is derived from list and can contain one one more instances of gdsii.structure.Structure.

GDS syntax for the library:

library ::=  HEADER
             BGNLIB
             [LIBDIRSIZE]
             [SRFNAME]
             [LIBSECUR]
             LIBNAME
             [REFLIBS]
             [FONTS]
             [ATTRTABLE]
             [GENERATIONS]
             [format]
             UNITS
             {structure}*
             ENDLIB
format  ::=  FORMAT
             [MASK+ ENDMASKS]

__init__(version, name, physical_unit, logical_unit, mod_time=None, acc_time=None)

Initialize the library. mod_time and acc_time are set to current UTC time by default.

Instance attributes:

version

GDSII file verion (int). Number as found in a GDSII file. For example value is 5 for GDSII v5 and 0x600 for GDSII v6.

name

Library name (bytes).

physical_unit

Size of database unit in meters (float).

logical_unit

Size of user unit in database units (float).

mod_time

Last modification time (datetime).

acc_time

Last access time (datetime).

libdirsize

Number of pages in the library directory (int, optional).

srfname

Name of spacing rules file (bytes, optional).

acls

ACL data (list of tuples (GID, UID, ACCESS), optional).

reflibs

Names of reference libraries (bytes, optional). See GDSII stream format documentation for format.

fonts

Names of font definition files (bytes, optional). The content is not parsed, see GDSII stream format documentation for format.

attrtable

Name of attribute definition file (bytes, optional).

generations

Number of copies for deleted structures (int, optional)

format

Library format (int, optional). Possible values:

• 0 – GDSII archive format
• 1 – GDSII filtered format
• 2 – EDSIII archive format
• 3 – EDSIII filtered format

masks

Masks for filtered format (list of bytes, optional).

classmethod load(stream)

Load a GDS library from a file.

Parameters:stream – a file or file-like object opened for reading in binary mode. Returns:a new library.

save(stream)

Save the library into a file.

Parameters:stream – a file or file-like object opened for writing in binary mode.