Package schrodinger :: Package application :: Package matsci :: Package nano :: Module surfaces_interfaces_mod :: Class Surfaces
[hide private]
[frames] | no frames]

Class Surfaces

object --+
         |
        Surfaces

Manage the enumeration of surfaces.

Instance Methods [hide private]
 
__init__(self, xtal_asu, surface_kwargs=None, logger=None)
Create an instance.
list
getHKLIndices(self)
Collect and return all hkl Miller index triples for this surface enumeration and sort them according to increasing l then k then h.
slab.Surface
getSurface(self, cell, hkl, logger=None)
Build and return a slab.Surface.
 
logParams(self)
Log the parameters.
schrodinger.structure.Structure
getXtalCell(self)
Build and return the crystal cell from which surfaces will be created.
list of slab.Surface
getSurfaces(self)
Build and return the slab.Surface objects for all surfaces.
 
writeSurfaces(self, file_name)
Write surfaces to a Maestro file with the given file name.
 
runIt(self)
Create the surfaces.

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __repr__, __setattr__, __sizeof__, __str__, __subclasshook__

Properties [hide private]

Inherited from object: __class__

Method Details [hide private]

__init__(self, xtal_asu, surface_kwargs=None, logger=None)
(Constructor)

 

Create an instance.

Parameters:
  • xtal_asu (schrodinger.structure.Structure) - the crystalline ASU from which to create surfaces
  • surface_kwargs (None or dict) - kwargs for the surface build or None if there are none in which case the defaults will be used
  • logger (logging.Logger or None) - output logger or None if there isn't one
Overrides: object.__init__

getHKLIndices(self)

 

Collect and return all hkl Miller index triples for this surface enumeration and sort them according to increasing l then k then h.

Returns: list
contains sorted tuples of hkl triples
Raises:
  • ValueError - if there are zero valid hkl triples

getSurface(self, cell, hkl, logger=None)

 

Build and return a slab.Surface.

Parameters:
  • cell (schrodinger.structure.Structure) - a cell
  • hkl (tuple) - a triple of Miller indices
  • logger (logging.Logger or None) - output logger or None if there isn't one
Returns: slab.Surface
the surface object

getXtalCell(self)

 

Build and return the crystal cell from which surfaces will be created.

Returns: schrodinger.structure.Structure
the crystal cell

getSurfaces(self)

 

Build and return the slab.Surface objects for all surfaces.

Returns: list of slab.Surface
contains surface objects

writeSurfaces(self, file_name)

 

Write surfaces to a Maestro file with the given file name.

Parameters:
  • file_name (str) - file name of the Maestro file