diffpy.structure package

Crystal structure container and parsers for structure formats.

Classes related to the structure of materials:

Atom
Lattice
Structure
PDFFitStructure

Other classes:

SpaceGroup
SymOp
ExpandAsymmetricUnit
GeneratorSite
SymmetryConstraints

Exceptions:

StructureFormatError
LatticeError
SymmetryError

class diffpy.structure.DeprecatedStructureModule[source]

Bases: object

Proxy for backward compatibility of diffpy.Structure.

diffpy.structure.loadStructure(filename, fmt='auto', **kw)

This function has been deprecated and will be removed in version 4.0.0.

Please use diffpy.structure.load_structure instead.

diffpy.structure.load_structure(filename, fmt='auto', **kw)[source]

Load new structure object from the specified file.

Parameters:

filename (str) – Path to the file to be loaded.
fmt (str, Optional) – Format of the structure file such as ‘cif’ or ‘xyz’. Must be one of the formats listed by the parsers.input_formats function. When ‘auto’, all supported formats are tried in a sequence.
kw (Optional) – Extra keyword arguments that are passed to parsers.get_parser function. These configure the dedicated Parser object that is used to read content in filename.

Returns:

stru – The new Structure object loaded from the specified file. Return a more specific PDFFitStructure type for ‘pdffit’ and ‘discus’ formats.

Return type:

Structure, PDFFitStructure

Subpackages

Submodules

diffpy.structure.structure_app module

diffpy.structure.structure_app.main()[source]

diffpy.structure.spacegroups module

Space group classes and definitions from mmLib and sgtbx.

diffpy.structure.spacegroups.SpaceGroupList

The list of all spacegroup definitions.

Type:: list

diffpy.structure.spacegroups.FindSpaceGroup(symops, shuffle=False)

This function has been deprecated and will be removed in version 4.0.0.

Please use diffpy.structure.find_space_group instead.

diffpy.structure.spacegroups.GetSpaceGroup(sgid)

This function has been deprecated and will be removed in version 4.0.0.

Please use diffpy.structure.get_space_group instead.

diffpy.structure.spacegroups.IsSpaceGroupIdentifier(sgid)

Check if identifier can be used as an argument to GetSpaceGroup.

Return type:: bool

diffpy.structure.spacegroups.find_space_group(symops, shuffle=False)[source]

Lookup SpaceGroup from a given list of symmetry operations.

Parameters:

symops (list) – The list of SymOp objects for which to find SpaceGroup.
shuffle (bool, Optional) – Flag for allowing different order of symops in the returned SpaceGroup. The default is False.

Returns:

The SpaceGroup object with equivalent list of symmetry operations. Return predefined SpaceGroup instance when symmetry operations have the same order or when the shuffle flag is set.

Return type:

SpaceGroup

Raises:

ValueError – When symops do not match any known SpaceGroup.

diffpy.structure.spacegroups.get_space_group(sgid)[source]

Returns the SpaceGroup instance for the given identifier.

Parameters:: sgid (str, int) – The space group symbol, either short_name or pdb_name, whatever it means in mmlib. Can be also an integer.
Returns:: The SpaceGroup object for the given identifier.
Return type:: SpaceGroup
Raises:: ValueError – When the identifier is not found.

diffpy.structure.spacegroups.is_space_group_identifier(sgid)[source]

Check if identifier can be used as an argument to GetSpaceGroup.

Return type:: bool

diffpy.structure._legacy_importer module

Support import of old camel-case module names with DeprecationWarning.

The imported camel-case modules are aliases for the current module instances. Their __name__ attributes are thus all in lower-case.

Note

this module must be only imported from diffpy.Structure.

Warning

This module is deprecated and will be removed in the future.

class diffpy.structure._legacy_importer.FindRenamedStructureModule[source]

Bases: MetaPathFinder

find_spec(fullname, path=None, target=None)[source]

prefix = 'diffpy.Structure.'

class diffpy.structure._legacy_importer.MapRenamedStructureModule[source]

Bases: Loader

Loader for old camel-case module names.

Import the current module and alias it under the old name.

create_module(spec)[source]

Return a module to initialize and into which to load.

This method should raise ImportError if anything prevents it from creating a new module. It may return None to indicate that the spec should create the new module.

exec_module(module)[source]

diffpy.structure.structureerrors module

Exceptions used in Structure package.

exception diffpy.structure.structureerrors.LatticeError[source]

Bases: Exception

Exception for impossible lattice parameters.

exception diffpy.structure.structureerrors.StructureFormatError[source]

Bases: Exception

Exception for failed IO from Structure file.

exception diffpy.structure.structureerrors.SymmetryError[source]

Bases: Exception

Exception raised for invalid symmetry operations.

diffpy.structure.spacegroupmod module

Symmetry operations as functions on vectors or arrays.

class diffpy.structure.spacegroupmod.SpaceGroup(number=None, num_sym_equiv=None, num_primitive_sym_equiv=None, short_name=None, point_group_name=None, crystal_system=None, pdb_name=None, symop_list=None)[source]

Bases: object

Definition and basic operations for a specific space group.

Provide standard names and all symmetry operations contained in one space group.

Parameters:

number (int) – The space group number.
num_sym_equiv (int) – The number of symmetry equivalent sites for a general position.
num_primitive_sym_equiv (int) – The number of symmetry equivalent sites in a primitive unit cell.
short_name (str) – The short Hermann-Mauguin symbol of the space group.
point_group_name (str) – The point group of this space group.
crystal_system (str) – The crystal system of this space group.
pdb_name (str) – The full Hermann-Mauguin symbol of the space group.
symop_list (list of SymOp) – The symmetry operations contained in this space group.

number

A unique space group number. This may be incremented by several thousands to facilitate unique values for multiple settings of the same space group. Use number % 1000 to get the standard space group number from International Tables.

Type:: int

num_sym_equiv

The number of symmetry equivalent sites for a general position.

Type:: int

num_primitive_sym_equiv

The number of symmetry equivalent sites in a primitive unit cell.

Type:: int

short_name

The short Hermann-Mauguin symbol of the space group.

Type:: str

point_group_name

The point group to which this space group belongs to.

Type:: str

crystal_system

The crystal system of this space group. The possible values are "TRICLINIC", "MONOCLINIC", "ORTHORHOMBIC", "TETRAGONAL", "TRIGONAL" "HEXAGONAL", "CUBIC".

Type:: str

pdb_name

The full Hermann-Mauguin symbol of the space group.

Type:: str

symop_list

A list of SymOp objects for all symmetry operations in this space group.

Type:: list of SymOp

check_group_name(name)[source]

Check if given name matches this space group.

Parameters:: name (str or int) – The space group identifier, a string name or number.
Returns:: True if the specified name matches one of the recognized names of this space group or if it equals its number. Return False otherwise.
Return type:: bool

iter_equivalent_positions(vec)[source]

Generate symmetry equivalent positions for the specified position.

The initial position must be in fractional coordinates and so are the symmetry equivalent positions yielded by iteration. This generates num_sym_equiv positions regardless of initial coordinates being a special symmetry position or not.

Parameters:: vec (numpy.ndarray) – The initial position in fractional coordinates.
Yields:: numpy.ndarray – The symmetry equivalent positions in fractional coordinates. The positions may be duplicate or outside of the 0 <= x < 1 unit cell bounds.

iter_symops()[source]

Iterate over all symmetry operations in the space group.

Yields:: SymOp – Generate all symmetry operations for this space group.

class diffpy.structure.spacegroupmod.SymOp(R, t)[source]

Bases: object

The transformation of coordinates to a symmetry-related position.

The SymOp operation involves rotation and translation in cell coordinates.

Parameters:

R (numpy.ndarray) – The 3x3 matrix of rotation for this symmetry operation.
t (numpy.ndarray) – The vector of translation in this symmetry operation.

R

The 3x3 matrix of rotation pertaining to unit cell coordinates. This may be identity, simple rotation, improper rotation, mirror or inversion. The determinant of R is either +1 or -1.

Type:: numpy.ndarray

t

The translation of cell coordinates applied after rotation R.

Type:: numpy.ndarray

is_identity()[source]

Check if this SymOp is an identity operation.

Returns:: True if this is an identity operation within a small round-off. Return False otherwise.
Return type:: bool

diffpy.structure.utils module

Small shared functions.

diffpy.structure.utils.atomBareSymbol(smbl)

This function has been deprecated and will be removed in version 4.0.0.

Please use diffpy.structure.atom_bare_symbol instead.

diffpy.structure.utils.atom_bare_symbol(smbl)[source]

Remove atom type string stripped of isotope and ion charge symbols.

This function removes any blank, isotope numbers (0-9), leading hyphens (-), and ion charge symbols (1-9)(+-) from the given atom type string, returning only the bare element symbol.

Parameters:: smbl (str) – Atom type string that may include isotope numbers, ion charges, or hyphens.
Returns:: The bare element symbol.
Return type:: str

Examples

>>> atom_bare_symbol("Cl-")
'Cl'
>>> atom_bare_symbol("Ca2+")
'Ca'
>>> atom_bare_symbol("12-C")
'C'

diffpy.structure.utils.isfloat(s)[source]: True if argument can be converted to float.

diffpy.structure.utils.isiterable(obj)[source]: True if argument is iterable.

diffpy.structure.lattice module

Class Lattice stores properties and provides simple operations in lattice coordinate system.

diffpy.structure.lattice.cartesian

The default Cartesian lattice with a=b=c=1 and alpha=beta=gamma=90 degrees.

Type:: Lattice

class diffpy.structure.lattice.Lattice(a=None, b=None, c=None, alpha=None, beta=None, gamma=None, baserot=None, base=None)[source]

Bases: object

General coordinate system and associated operations.

Parameters:

a (float or Lattice, Optional) – The cell length a. When present, other cell parameters must be also specified. When of the Lattice type, create a duplicate Lattice.
b (float) – The cell length b.
c (float) – The cell length c.
alpha (float) – The angle between the b and c axes in degrees.
beta (float) – The angle between the b and c axes in degrees.
gamma (float) – The angle between the a and b axes in degrees.
baserot (array_like, Optional) – The 3x3 rotation matrix of the base vectors with respect to their standard setting.
base (array_like, Optional) – The 3x3 array of row base vectors. This must be the only argument when present.

metrics

The metrics tensor.

Type:: numpy.ndarray

base

The 3x3 matrix of row base vectors in Cartesian coordinates, which may be rotated, i.e., base = stdbase @ baserot.

Type:: numpy.ndarray

stdbase

The 3x3 matrix of row base vectors in standard orientation.

Type:: numpy.ndarray

baserot

The rotation matrix for the base.

Type:: numpy.ndarray

recbase

The inverse of the base matrix, where the columns give reciprocal vectors in Cartesian coordinates.

Type:: numpy.ndarray

normbase

The base vectors scaled by magnitudes of reciprocal cell lengths.

Type:: numpy.ndarray

recnormbase

The inverse of the normbase matrix.

Type:: numpy.ndarray

isotropicunit

The 3x3 tensor for a unit isotropic displacement parameters in this coordinate system. This is an identity matrix when this Lattice is orthonormal.

Type:: numpy.ndarray

Note

The array attributes are read-only. They get updated by changing some lattice parameters or by calling the set_latt_parms() or set_new_latt_base_vec() methods.

Examples

Create a Cartesian coordinate system:

>>> Lattice()

Create coordinate system with the cell lengths a, b, c and cell angles alpha, beta, gamma in degrees:

>>> Lattice(a, b, c, alpha, beta, gamma)

Create a duplicate of an existing Lattice lat:

>>> Lattice(lat)

Create coordinate system with the base vectors given by rows of the abc matrix:

>>> Lattice(base=abc)

property a: The unit cell length a.

abcABG()

‘diffpy.structure.Lattice.abcABG’ is deprecated and will be removed in version 4.0.0.

Please use ‘diffpy.structure.Lattice.cell_parms’ instead.

property alpha: The cell angle alpha in degrees.

property alphar: The reciprocal cell angle alpha in degrees.

angle(u, v)[source]

Calculate angle between 2 lattice vectors in degrees.

Parameters:

u (array_like) – The first lattice vector.
v (array_like) – The second lattice vector.

Returns:

The angle between lattice vectors u and v in degrees.

Return type:

float

property ar: The cell length a of the reciprocal lattice.

property b: The unit cell length b.

property beta: The cell angle beta in degrees.

property betar: The reciprocal cell angle beta in degrees

property br: The cell length b of the reciprocal lattice.

property c: The unit cell length c.

property ca: The cosine of the cell angle alpha.

property car: The cosine of the reciprocal angle alpha.

cartesian(u)[source]

Transform lattice vector to Cartesian coordinates.

Parameters:: u (array_like) – Vector of lattice coordinates or an Nx3 array of lattice vectors.
Returns:: rc – Cartesian coordinates of the u vector.
Return type:: numpy.ndarray

property cb: The cosine of the cell angle beta.

property cbr: The cosine of the reciprocal angle beta.

cell_parms()[source]

Return the cell parameters in the standard setting.

Returns:: A tuple of (a, b, c, alpha, beta, gamma).
Return type:: tuple

property cg: The cosine of the cell angle gamma.

property cgr: The cosine of the reciprocal angle gamma.

property cr: The cell length c of the reciprocal lattice.

dist(u, v)[source]

Calculate distance between 2 points in lattice coordinates.

Parameters:

u (array_like) – A vector or an Nx3 matrix of fractional coordinates.
v (numpy.ndarray) – A vector or an Nx3 matrix of fractional coordinates.

Note

u and v must be of the same shape when matrices.

Returns:: The distance between lattice points u and v.
Return type:: float or numpy.ndarray

dot(u, v)[source]

Calculate dot product of 2 lattice vectors.

Parameters:

u (array_like) – The first lattice vector or an Nx3 array.
v (array_like) – The second lattice vector or an array of the same shape as u.

Returns:

The dot product of lattice vectors u, v.

Return type:

float or numpy.ndarray

fractional(rc)[source]

Transform Cartesian vector to fractional lattice coordinates.

Parameters:: rc (array_like) – A vector of Cartesian coordinates or an Nx3 array of Cartesian vectors.
Returns:: u – Fractional coordinates of the Cartesian vector rc.
Return type:: numpy.ndarray

property gamma: The cell angle gamma in degrees.

property gammar: The reciprocal cell angle gamma in degrees

isanisotropic(umx)[source]

True if displacement parameter matrix is anisotropic.

This checks if the specified matrix of anisotropic displacement parameters (ADP) differs from isotropic values for this lattice by more than a small round-off error.

Parameters:: umx (array_like) – The 3x3 matrix of displacement parameters.
Returns:: True when umx is anisotropic by more than a round-off error.
Return type:: bool

norm(xyz)[source]

Calculate norm of a lattice vector.

Parameters:: xyz (array_like) – A vector or an Nx3 array of fractional coordinates.
Returns:: The magnitude of the lattice vector xyz.
Return type:: float or numpy.ndarray

reciprocal()[source]

Return the reciprocal lattice of the current lattice.

Returns:: The reciprocal lattice of the current lattice.
Return type:: Lattice

rnorm(hkl)[source]

Calculate norm of a reciprocal vector.

Parameters:: hkl (array_like) – A vector or an Nx3 array of reciprocal coordinates.
Returns:: The magnitude of the reciprocal vector hkl.
Return type:: float or numpy.ndarray

property sa: The sine of the cell angle alpha.

property sar: The sine of the reciprocal angle alpha.

property sb: The sine of the cell angle beta.

property sbr: The sine of the reciprocal angle beta.

setLatBase(base)

This function has been deprecated and will be removed in version 4.0.0.

Please use diffpy.structure.Lattice.set_lat_base instead.

setLatPar(a=None, b=None, c=None, alpha=None, beta=None, gamma=None, baserot=None)

This function has been deprecated and will be removed in version 4.0.0.

Please use diffpy.structure.Lattice.set_lat_par instead.

set_latt_parms(a=None, b=None, c=None, alpha=None, beta=None, gamma=None, baserot=None)[source]

Set one or more lattice parameters.

This updates all attributes that depend on the lattice parameters.

Parameters:

a (float, Optional) – The new value of the cell length a.
b (float, Optional) – The new value of the cell length b.
c (float, Optional) – The new value of the cell length c.
alpha (float, Optional) – The new value of the cell angle alpha in degrees.
beta (float, Optional) – The new value of the cell angle beta in degrees.
gamma (float, Optional) – The new value of the cell angle gamma in degrees.
baserot (array_like, Optional) – The new 3x3 rotation matrix of the base vectors with respect to their standard setting in Cartesian coordinates.

Note

Parameters that are not specified will keep their initial values.

set_new_latt_base_vec(base)[source]

Set new base vectors for this lattice.

This updates the cell lengths and cell angles according to the new base. The stdbase, baserot, and metrics attributes are also updated.

Parameters:: base (array_like) – The 3x3 matrix of row base vectors expressed in Cartesian coordinates.

property sg: The sine of the cell angle gamma.

property sgr: The sine of the reciprocal angle gamma.

property unitvolume: The unit cell volume when a = b = c = 1.

property volume: The unit cell volume.

diffpy.structure.lattice.cosd(x)[source]

Return the cosine of x (measured in degrees).

Avoid round-off errors for exact cosine values.

Parameters:: x (float) – The angle in degrees.
Returns:: The cosine of the angle x.
Return type:: float

diffpy.structure.lattice.sind(x)[source]

Return the sine of x (measured in degrees).

Avoid round-off errors for exact sine values.

Parameters:: x (float) – The angle in degrees.
Returns:: The sine of the angle x.
Return type:: float

diffpy.structure.structure module

This module defines class Structure.

class diffpy.structure.structure.Structure(atoms=None, lattice=None, title=None, filename=None, format=None)[source]

Bases: list

Define group of atoms in a specified lattice. Structure –> group of atoms.

Structure class is inherited from Python list. It contains a list of Atom instances. Structure overloads setitem and setslice methods so that the lattice attribute of atoms get set to lattice.

Parameters:

atoms (list of Atom or Structure, Optional) – The list of Atom instances to be included in this Structure. When atoms argument is an existing Structure instance, the new structure is its copy.
lattice (Lattice, Optional) – The instance of Lattice defining coordinate systems, property.
title (str, Optional) – The string description of the structure.
filename (str, Optional) – The name of a file to load the structure from.
format (str, Optional) – The Structure format of the loaded filename. By default all structure formats are tried one by one. Ignored when filename has not been specified.

Note

Cannot use filename and atoms arguments together. Overrides atoms argument when filename is specified.

title

The string description of the structure, default “”.

Type:: str

lattice

The instance of Lattice defining coordinate systems.

Type:: Lattice

pdffit

The dictionary of PDFFit-related metadata, default None.

Type:: None or dict

element

The character array of Atom types. Assignment updates the element attribute of the respective Atoms. Set the maximum length of the element string to 5 characters.

Type:: ndarray of str

xyz

The array of fractional coordinates of all Atoms. Assignment updates xyz attribute of all Atoms

Type:: ndarray

x

The array of fractional coordinate x. Assignment updates the xyz attribute of all Atoms.

Type:: ndarray

y

The array of fractional coordinate y. Assignment updates the xyz attribute of all Atoms.

Type:: ndarray

z

The array of fractional coordinate z. Assignment updates the xyz attribute of all Atoms.

Type:: ndarray

label

The character array of Atom names. Assignment updates the label attribute of all Atoms. Set the maximum length of the label string to 5 characters.

Type:: ndarray of str

occupancy

The array of Atom occupancies. Assignment updates the occupancy attribute of all Atoms.

Type:: ndarray

xyz_cartn

The array of absolute Cartesian coordinates of all Atoms. Assignment updates the xyz attribute of all Atoms.

Type:: ndarray

anisotropy

The boolean array for anisotropic thermal displacement flags. Assignment updates the anisotropy attribute of all Atoms.

Type:: ndarray of bool

U

The array of anisotropic thermal displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

Type:: ndarray

Uisoequiv

The array of isotropic thermal displacement or equivalent values. Assignment updates the U attribute of all Atoms.

Type:: ndarray

U11

The array of U11 elements of the anisotropic displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

Type:: ndarray

U22

The array of U22 elements of the anisotropic displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

Type:: ndarray

U33

The array of U33 elements of the anisotropic displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

Type:: ndarray

U12

The array of U12 elements of the anisotropic displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

Type:: ndarray

U13

The array of U13 elements of the anisotropic displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

Type:: ndarray

U23

The array of U23 elements of the anisotropic displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

Type:: ndarray

Bisoequiv

The array of Debye-Waller isotropic thermal displacement or equivalent values for all Atoms. Assignment updates the U attribute of all Atoms.

Type:: ndarray

B11

The array of B11 elements of the Debye-Waller displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

Type:: ndarray

B22

The array of B22 elements of the Debye-Waller displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

Type:: ndarray

B33

The array of B33 elements of the Debye-Waller displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

Type:: ndarray

B12

The array of B12 elements of the Debye-Waller displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

Type:: ndarray

B13

The array of B13 elements of the Debye-Waller displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

Type:: ndarray

B23

The array of B23 elements of the Debye-Waller displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

Type:: ndarray

Examples

Structure(stru) create a copy of Structure instance stru.

>>> stru = Structure()
>>> copystru = Structure(stru)

Structure is inherited from a list it can use list expansions.

>>> oxygen_atoms = [a for a in stru if a.element == "O" ]
>>> oxygen_stru = Structure(oxygen_atoms, lattice=stru.lattice)

property B11: The B11 elements of the Debye-Waller displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

property B12: The B12 elements of the Debye-Waller displacement tensors.Assignment updates the U and anisotropy attributes of all Atoms.

property B13: The B13 elements of the Debye-Waller displacement tensors.Assignment updates the U and anisotropy attributes of all Atoms.

property B22: The B22 elements of the Debye-Waller displacement tensors.Assignment updates the U and anisotropy attributes of all Atoms.

property B23: The B23 elements of the Debye-Waller displacement tensors.Assignment updates the U and anisotropy attributes of all Atoms.

property B33: The B33 elements of the Debye-Waller displacement tensors.Assignment updates the U and anisotropy attributes of all Atoms.

property Bisoequiv: The Debye-Waller isotropic thermal displacement or equivalent values.Assignment updates the U attribute of all Atoms.

property U: The anisotropic thermal displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

property U11: The U11 elements of the anisotropic displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

property U12: The U12 elements of the anisotropic displacement tensors.Assignment updates the U and anisotropy attributes of all Atoms.

property U13: The U13 elements of the anisotropic displacement tensors.Assignment updates the U and anisotropy attributes of all Atoms.

property U22: The U22 elements of the anisotropic displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

property U23: The U23 elements of the anisotropic displacement tensors.Assignment updates the U and anisotropy attributes of all Atoms.

property U33: The U33 elements of the anisotropic displacement tensors. Assignment updates the U and anisotropy attributes of all Atoms.

property Uisoequiv: The isotropic thermal displacement or equivalent values. Assignment updates the U attribute of all Atoms.

addNewAtom(*args, **kwargs)

This function has been deprecated and will be removed in version 4.0.0.

Please use diffpy.structure.Structure.add_new_atom instead.

add_new_atom(*args, **kwargs)[source]

Add new Atom instance to the end of this Structure.

Parameters:

*args – See Atom class constructor.
**kwargs – See Atom class constructor.

Raises:

UserWarning – If an atom with the same element/type and coordinates already exists.

angle(aid0, aid1, aid2)[source]

The bond angle at the second of three Atoms in degrees.

Parameters:

aid0 (int or str) – Zero based index of the first Atom or a string label.
aid1 (int or str) – Index or string label for the second atom, where the angle is formed.
aid2 (int or str) – Index or string label for the third atom.

Returns:

The bond angle in degrees.

Return type:

float

Raises:

IndexError – If any of the arguments are invalid.

property anisotropy: The anisotropic thermal displacement flags. Assignment updates the anisotropy attribute of all Atoms.

append(a, copy=True)[source]

Append Atom to a structure and update its lattice attribute.

Parameters:

a (Atom) – Instance of Atom to be appended.
copy (bool, Optional) – Flag for appending a copy of a. When False, append a and update a.lattice.

assignUniqueLabels()

This function has been deprecated and will be removed in version 4.0.0.

Please use diffpy.structure.Structure.assign_unique_labels instead.

assign_unique_labels()[source]

Set a unique label string for each Atom in this structure.

The label strings are formatted as “%(baresymbol)s%(index)i”, where baresymbol is the element right-stripped of “[0-9][+-]”.

property composition: Dictionary of chemical symbols and their total occupancies.

copy()[source]: Return a copy of this Structure object.

distance(aid0, aid1)[source]

Calculate distance between 2 Atoms, no periodic boundary conditions.

Parameters:

aid0 (int or str) – Zero based index of the first Atom or a string label.
aid1 (int or str) – Zero based index or string label of the second atom.

Returns:

Distance between the two Atoms in Angstroms.

Return type:

float

Raises:

IndexError – If any of the Atom indices or labels are invalid.

property element: Character array of Atom types. Assignment updates the element attribute of the respective Atoms. Set the maximum length of the element string to 5 characters.

extend(atoms, copy=None)[source]

Extend Structure with an iterable of atoms.

Update the lattice attribute of all added atoms.

Parameters:

atoms (Iterable) – The Atom objects to be appended to this Structure.
copy (bool, Optional) – Flag for adding copies of Atom objects. Make copies when True, append atoms unchanged when False. The default behavior is to make copies when atoms are of Structure type or if new atoms introduce repeated objects.

getLastAtom()

This function has been deprecated and will be removed in version 4.0.0.

Please use diffpy.structure.Structure.get_last_atom instead.

get_anisotropic_displacement_parameters(return_array=False)[source]

Return the anisotropic displacement parameters for all atoms.

Parameters:: return_array (bool, optional) – If True, return anisotropic displacement parameters as a numpy array instead of a dictionary.
Returns:: The dictionary of anisotropic displacement parameters for all atoms in this structure. Keys are of the form ‘Element_i_Ujk’, e.g. ‘C_0_11’, ‘C_0_12’.
Return type:: dict

get_cartesian_coordinates()[source]

Return array of Cartesian coordinates of all Atoms in this structure.

Returns:: The array of Cartesian coordinates of all Atoms in this structure in the same order as Structure.get_chemical_symbols().
Return type:: numpy.ndarray

get_chemical_symbols()[source]

Return list of chemical symbols for all Atoms in this structure.

Returns:: The list of chemical symbols for all Atoms in this structure.
Return type:: list of str

get_fractional_coordinates()[source]

Return array of fractional coordinates of all Atoms in this structure.

Returns:: The array of fractional coordinates of all Atoms in this structure in the same order as Structure.get_chemical_symbols().
Return type:: numpy.ndarray

get_isotropic_displacement_parameters(return_array=False)[source]

Return a the isotropic displacement parameters for all atoms.

Parameters:: return_array (bool, optional) – If True, return isotropic displacement parameters as a numpy array instead of a dictionary. Default is False.
Returns:: The dictionary of isotropic displacement parameters for all atoms in this structure. Keys are of the form ‘Element_i_Uiso’, e.g. ‘C_0_Uiso’.
Return type:: dict

get_last_atom()[source]: Return Reference to the last Atom in this structure.

get_lattice_vector_angles()[source]

Return array of lattice vector angles for this structure.

Returns:: The array of lattice vector angles for this structure.
Return type:: numpy.ndarray

get_lattice_vectors()[source]

Return array of lattice vectors for this structure.

Returns:: The array of lattice vectors for this structure.
Return type:: numpy.ndarray

get_occupancies()[source]

Return array of occupancies of all Atoms in this structure.

Returns:: The array of occupancies of all Atoms in this structure.
Return type:: numpy.ndarray

insert(idx, a, copy=True)[source]

Insert Atom a before position idx in this Structure.

Parameters:

idx (int) – Position in Atom list.
a (Atom) – Instance of Atom to be inserted.
copy (bool, Optional) – Flag for inserting a copy of a. When False, append a and update a.lattice.

property label: Character array of Atom names. Assignment updates the label attribute of all Atoms. Set the maximum length of the label string to 5 characters.

property lattice: Coordinate system for this Structure.

property occupancy: The Atom occupancies. Assignment updates the occupancy attributes of all Atoms

pdffit = None

placeInLattice(new_lattice)

This function has been deprecated and will be removed in version 4.0.0.

Please use diffpy.structure.Structure.place_in_lattice instead.

place_in_lattice(new_lattice)[source]

Place structure into new_lattice coordinate system.

Sets lattice to new_lattice and recalculate fractional coordinates of all Atoms so their absolute positions remain the same.

Parameters:: new_lattice (Lattice) – New lattice to place the structure into.
Returns:: Reference to this Structure object. The lattice attribute is updated to new_lattice.
Return type:: Structure

read(filename, format='auto')[source]

Load structure from a file, any original data become lost.

Parameters:

filename (str) – File to be loaded.
format (str, Optional) – All structure formats are defined in parsers submodule, when format == 'auto' all parsers are tried one by one.

Returns:

Return instance of data Parser used to process input string. This can be inspected for information related to particular format.

Return type:

Parser

readStr(s, format='auto')

This function has been deprecated and will be removed in version 4.0.0.

Please use diffpy.structure.Structure.read_structure instead.

read_structure(s, format='auto')[source]

Read structure from a string.

Parameters:

s (str) – String with structure definition.
format (str, Optional) – All structure formats are defined in parsers submodule. When format == 'auto', all parsers are tried one by one.

Returns:

Return instance of data Parser used to process input string. This can be inspected for information related to particular format.

Return type:

Parser

title = ''

tolist()[source]: Return Atoms in this Structure as a standard Python list.

write(filename, format)[source]

Save structure to file in the specified format.

Parameters:

filename (str) – File to save the structure to.
format (str) – Structure format to use for saving.

Note

Available structure formats can be obtained by:

from parsers import formats

writeStr(format)

This function has been deprecated and will be removed in version 4.0.0.

Please use diffpy.structure.Structure.write_structure instead.

write_structure(format)[source]: Return string representation of the structure in specified format.

Note

Available structure formats can be obtained by:

from parsers import formats

property x: Array of all fractional coordinates x. Assignment updates xyz attribute of all Atoms.

property xyz: Array of fractional coordinates of all Atoms. Assignment updates xyz attribute of all Atoms.

property xyz_cartn: The Atom absolute Cartesian coordinates. Assignment updates the xyz attribute of all Atoms.

property y: Array of all fractional coordinates y. Assignment updates xyz attribute of all Atoms.

property z: Array of all fractional coordinates z. Assignment updates xyz attribute of all Atoms.

diffpy.structure.mmlibspacegroups module

Space groups defined as a part of the pymmlib.

diffpy.structure.symmetryutilities module

Symmetry utility functions such as expansion of asymmetric unit, and generation of positional constraints.

diffpy.structure.symmetryutilities.epsilon

The default tolerance for equality of 2 positions, also used for identification of special positions.

Type:: float

diffpy.structure.symmetryutilities.stdUsymbols

The standard symbols denoting elements of anisotropic thermal displacement tensor.

Type:: list

class diffpy.structure.symmetryutilities.ExpandAsymmetricUnit(spacegroup, corepos, coreUijs=None, sgoffset=[0, 0, 0], eps=None)[source]

Bases: object

Expand asymmetric unit and anisotropic thermal displacement.

Parameters:

spacegroup (SpaceGroup) – Instance of SpaceGroup.
corepos (array_like) – List of positions in asymmetric unit, it may contain duplicates.
coreUijs (numpy.ndarray, Optional) – Thermal factors for corepos.
sgoffset (list, Optional) – Offset of space group origin [0, 0, 0]. Default is [0, 0, 0].
eps (float, Optional) – Cutoff for duplicate positions. Default is 1.0e-5.

spacegroup

The instance of SpaceGroup.

Type:: SpaceGroup

corepos

The list of positions in asymmetric unit, it may contain duplicates.

Type:: array_like

coreUijs

The thermal factors for corepos. Defaults to zeros.

Type:: numpy.ndarray

sgoffset

The offset of space group origin [0, 0, 0]. Default to zeros.

Type:: numpy.ndarray

eps

The cutoff for equivalent positions. Default is 1.0e-5.

Type:: float

multiplicity

The multiplicity of each site in corepos.

Type:: list

Uisotropy

The bool flags for isotropic sites in corepos.

Type:: list

expandedpos

The list of equivalent positions per each site in corepos.

Type:: list

expandedUijs

The list of thermal factors per each site in corepos.

Type:: list

class diffpy.structure.symmetryutilities.GeneratorSite(spacegroup, xyz, Uij=array([[0., 0., 0.], [0., 0., 0.], [0., 0., 0.]]), sgoffset=[0, 0, 0], eps=None)[source]

Bases: object

Storage of data related to a generator positions.

Parameters:

spacegroup (SpaceGroup) – Instance of SpaceGroup.
xyz (array_like) – Generating site. When xyz is close to special position self.xyz will be adjusted.
Uij (array_like, Optional) – Thermal factors at generator site. Yields self.Uij after adjusting to spacegroup symmetry. Default is zeros.
sgoffset (list, Optional) – Offset of space group origin [0, 0, 0]. Default is [0, 0, 0].
eps (float, Optional) – Cutoff for equal positions. Default is 1.0e-5.

xyz

The fractional coordinates of generator site.

Type:: numpy.ndarray

Uij

The anisotropic thermal displacement at generator site.

Type:: numpy.ndarray

sgoffset

The offset of space group origin [0, 0, 0].

Type:: numpy.ndarray

eps

The cutoff for equal positions.

Type:: float

eqxyz

The list of equivalent positions.

Type:: list

eqUij

The list of displacement matrices at equivalent positions.

Type:: list

symops

The nested list of operations per each eqxyz.

Type:: list

multiplicity

The generator site multiplicity.

Type:: int

Uisotropy

The bool flag for isotropic thermal factors.

Type:: bool

invariants

The list of invariant operations for generator site.

Type:: list

null_space

The null space of all possible differences of invariant rotational matrices, this is a base of symmetry allowed shifts.

Type:: numpy.ndarray

Uspace

The 3D array of independent components of U matrices.

Type:: numpy.ndarray

pparameters

The list of (xyz symbol, value) pairs.

Type:: list

Uparameters

The list of (U symbol, value) pairs.

Type:: list

idx2Usymbol

The mapping of index to standard U symbol.

Type:: dict

Ucomponents

The 6x3x3 array of independent components of U matrices.

Type:: numpy.ndarray

UFormula(pos, Usymbols=['U11', 'U22', 'U33', 'U12', 'U13', 'U23'])

‘diffpy.structure.GeneratorSite.UFormula’ is deprecated and will be removed in version 4.0.0.

Please use ‘diffpy.structure.GeneratorSite.u_formula’ instead.

Ucomponents = array([[[1., 0., 0.], [0., 0., 0.], [0., 0., 0.]], [[0., 0., 0.], [0., 1., 0.], [0., 0., 0.]], [[0., 0., 0.], [0., 0., 0.], [0., 0., 1.]], [[0., 1., 0.], [1., 0., 0.], [0., 0., 0.]], [[0., 0., 1.], [0., 0., 0.], [1., 0., 0.]], [[0., 0., 0.], [0., 0., 1.], [0., 1., 0.]]])

convert_fp_num_to_signed_rational(x)[source]

Convert floating point number to signed rational representation.

Possible fractional are multiples of 1/3, 1/6, 1/7, 1/9, if these are not close, return %+g format.

Parameters:: x (float) – Floating point number.
Returns:: Signed rational representation of x.
Return type:: str

eqIndex(pos)

‘diffpy.structure.GeneratorSite.eqIndex’ is deprecated and will be removed in version 4.0.0.

Please use ‘diffpy.structure.GeneratorSite.eq_index’ instead.

eq_index(pos)[source]

Index of the nearest generator equivalent site.

Parameters:: pos (array_like) – Fractional coordinates.
Returns:: Index of the nearest generator equivalent site.
Return type:: int

idx2Usymbol = {0: 'U11', 1: 'U12', 2: 'U13', 3: 'U12', 4: 'U22', 5: 'U23', 6: 'U13', 7: 'U23', 8: 'U33'}

positionFormula(pos, xyzsymbols=('x', 'y', 'z'))

‘diffpy.structure.GeneratorSite.positionFormula’ is deprecated and will be removed in version 4.0.0.

Please use ‘diffpy.structure.GeneratorSite.position_formula’ instead.

position_formula(pos, xyzsymbols=('x', 'y', 'z'))[source]

Formula of equivalent position with respect to generator site.

Parameters:

pos (array_like) – Fractional coordinates of possibly equivalent site.
xyzsymbols (tuple, Optional) – Symbols for parametrized coordinates.

Returns:

Position formulas in a dictionary with keys equal ("x", "y", "z") or an empty dictionary when pos is not equivalent to generator. Formulas are formatted as [[-][%g*]{x|y|z}] [{+|-}%g], for example -x, z +0.5, 0.25.

Return type:

dict

signedRatStr(x)

‘diffpy.structure.GeneratorSite.signedRatStr’ is deprecated and will be removed in version 4.0.0.

Please use ‘diffpy.structure.GeneratorSite.convert_fp_num_to_signed_rational’ instead.

u_formula(pos, Usymbols=['U11', 'U22', 'U33', 'U12', 'U13', 'U23'])[source]

List of atom displacement formulas with custom parameter symbols.

Parameters:

pos (array_like) – Fractional coordinates of possibly equivalent site.
Usymbols (list, Optional) – 6 symbols for possible U matrix parameters, default is ["U11", "U22", "U33", "U12", "U13", "U23"].

Returns:

Uformula – U element formulas in a dictionary where keys are from ('U11','U22','U33','U12','U13','U23') or empty dictionary when pos is not equivalent to generator.

Return type:

dict

class diffpy.structure.symmetryutilities.SymmetryConstraints(spacegroup, positions, Uijs=None, sgoffset=[0, 0, 0], eps=None)[source]

Bases: object

Generate symmetry constraints for specified positions.

Parameters:

spacegroup (SpaceGroup) – Instance of SpaceGroup.
positions (array_like) – List of all positions to be constrained.
Uijs (array_like, Optional) – List of U matrices for all constrained positions.
sgoffset (list, Optional) – Offset of space group origin [0, 0, 0]. Default is [0, 0, 0].
eps (float, Optional) – Cutoff for duplicate positions. Default is 1.0e-5.

spacegroup

The instance of SpaceGroup.

Type:: SpaceGroup

positions

All positions to be constrained.

Type:: numpy.ndarray

Uijs

The thermal factors for all positions. Defaults to zeros.

Type:: numpy.ndarray

sgoffset

The optional offset of space group origin [0, 0, 0].

Type:: numpy.ndarray

eps

The cutoff for equivalent positions. Default is 1.0e-5.

Type:: float

corepos

The list of positions in the asymmetric unit.

Type:: list

coremap

The dictionary mapping indices of asymmetric core positions to indices of all symmetry related positions.

Type:: dict

poseqns

The list of coordinate formula dictionaries per each site. Formula dictionary keys are from ("x", "y", "z") and the values are formatted as [[-]{x|y|z}%i] [{+|-}%g], for example: x0, -x3, z7 +0.5, 0.25.

Type:: list

pospars

The list of (xyz symbol, value) pairs.

Type:: list

Ueqns

The list of anisotropic atomic displacement formula dictionaries per each position. Formula dictionary keys are from ('U11','U22','U33','U12','U13','U23') and the values are formatted as {[%g*][Uij%i]|0}, for example: U110, 0.5*U2213, 0.

Type:: list

Upars

The list of (U symbol, value) pairs.

Type:: list

Uisotropy

The list of bool flags for isotropic thermal displacements.

Type:: list

UFormulas(Usymbols=None)

‘diffpy.structure.SymmetryConstraints.UFormulas’ is deprecated and will be removed in version 4.0.0.

Please use ‘diffpy.structure.SymmetryConstraints.u_formulas’ instead.

UFormulasPruned(Usymbols=None)

‘diffpy.structure.SymmetryConstraints.UFormulasPruned’ is deprecated and will be removed in version 4.0.0.

Please use ‘diffpy.structure.SymmetryConstraints.u_formulas_pruned’ instead.

UparSymbols()

‘diffpy.structure.SymmetryConstraints.UparSymbols’ is deprecated and will be removed in version 4.0.0.

Please use ‘diffpy.structure.SymmetryConstraints.u_parm_symbols’ instead.

UparValues()

‘diffpy.structure.SymmetryConstraints.UparValues’ is deprecated and will be removed in version 4.0.0.

Please use ‘diffpy.structure.SymmetryConstraints.u_parm_values’ instead.

pos_parm_symbols()[source]: Return list of standard position parameter symbols.

pos_parm_values()[source]: Return list of position parameters values.

positionFormulas(xyzsymbols=None)

‘diffpy.structure.SymmetryConstraints.positionFormulas’ is deprecated and will be removed in version 4.0.0.

Please use ‘diffpy.structure.SymmetryConstraints.position_formulas’ instead.

positionFormulasPruned(xyzsymbols=None)

‘diffpy.structure.SymmetryConstraints.positionFormulasPruned’ is deprecated and will be removed in version 4.0.0.

Please use ‘diffpy.structure.SymmetryConstraints.position_formulas_pruned’ instead.

position_formulas(xyzsymbols=None)[source]

List of position formulas with custom parameter symbols.

Parameters:: xyzsymbols (list, Optional) – List of custom symbols used in formula strings.
Returns:: List of coordinate formulas dictionaries. Formulas dictionary keys are from ("x", "y", "z") and the values are formatted as [[-]{symbol}] [{+|-}%g], for example: x0, -sym, @7 +0.5, 0.25.
Return type:: list

position_formulas_pruned(xyzsymbols=None)[source]

List of position formula dictionaries with constant items removed.

diffpy.structure.atom module

Provide class Atom for managing properties of an atom in structure model.

class diffpy.structure.atom.Atom(atype=None, xyz=None, label=None, occupancy=None, anisotropy=None, U=None, Uisoequiv=None, lattice=None)[source]

Bases: object

The storage of structure information relevant for a single atom.

This class manages atom information such as element symbol, position in fractional and Cartesian coordinates, atomic displacement parameters and so forth.

Parameters:

atype (str or Atom, Optional) – The string atom type to be set as the element attribute. By default an empty string. When of the Atom type, create a copy of atype and adjust it per other arguments.
xyz (numpy.ndarray, Optional) – The fractional coordinates within the associated lattice. By default [0, 0, 0].
label (str, Optional) – The unique string label for referring to this Atom. By default an empty string.
occupancy (float, Optional) – The initial occupancy of this atom, by default 1.
anisotropy (bool, Optional) – The flag for anisotropic thermal displacements parameters. This overrides anisotropy implied by presence of the U or Uisoequiv arguments. Defaults to False when not set in any other way.
U (numpy.ndarray, Optional) – The 3x3 matrix of anisotropic thermal displacement parameters. When present anisotropy defaults to True.
Uisoequiv (float, Optional) – The isotropic atomic displacement parameter. The anisotropy defaults to False when present. Only one of the U and Uisoequiv arguments may be provided at the same time. Assume zero atomic displacements when U and Uisoequiv are unset.
lattice (Lattice, Optional) – The coordinate system for the fractional coordinates xyz. Use the absolute Cartesian system when None.

element

The string type of the atom. An element or ion symbol, default “”.

Type:: str

xyz

The fractional coordinates in the associated lattice.

Type:: numpy.ndarray

label

The unique string label referring to this atom, for example, “C_1”. The label can be used to reference this atom when contained in a Structure object, default “”.

Type:: str

occupancy

The fractional occupancy of this atom, default 1.0.

Type:: float

lattice

The coordinate system for the fractional coordinates xyz and the tensor of atomic displacement parameters U. Use the absolute Cartesian coordinates when None as the default.

Type:: Lattice

Note

Cannot use both U and Uisoequiv arguments at the same time.

property B11

The B11 element of the Debye-Waller matrix, as a float

This is equivalent to 8 * pi**2 * U11. When anisotropy is False setting a new value updates entire tensor U.

property B12

The B12 element of the Debye-Waller matrix, as a float

This is equivalent to 8 * pi**2 * U12. Setting a new value updates U in a symmetric way. Assignment has no effect when anisotropy is False.

property B13

The B13 element of the Debye-Waller matrix, as a float

This is equivalent to 8 * pi**2 * U13. Setting a new value updates U in a symmetric way. Assignment has no effect when anisotropy is False.

property B22

The B22 element of the Debye-Waller matrix, as a float

This is equivalent to 8 * pi**2 * U22. When anisotropy is False setting a new value updates entire tensor U.

property B23

The B23 element of the Debye-Waller matrix, as a float

This is equivalent to 8 * pi**2 * U23. Setting a new value updates U in a symmetric way. Assignment has no effect when anisotropy is False.

property B33

The B33 element of the Debye-Waller matrix, as a float

This is equivalent to 8 * pi**2 * U33. When anisotropy is False setting a new value updates entire tensor U.

property Bisoequiv

The Debye-Waller isotropic displacement or an equivalent value, as a float.

This equals 8 * pi**2 * Uisoequiv. Setting a new value rescales U tensor to yield equivalent direction-average of Debye-Waller displacements.

property U

The 3x3 matrix of anisotropic atomic displacements, as a ndarray.

For isotropic displacements (when anisotropy is False) assignment to U uses only the first Unew[0, 0] element and the remaining components of U are adjusted to obtain isotropic tensor in the active lattice.

Note

Elements of the U tensor such as U[0, 1] should be considered read-only as setting them directly leads to undefined behavior. Use the U11, U22, …, or B11, B22, …, descriptors to set only some U components.

property U11

The U[0, 0] component of the displacement tensor U, as a float

When anisotropy is False setting a new value updates entire tensor U.

property U12

The U[0, 1] element of the displacement tensor U, as a float

Sets U[1, 0] together with U[0, 1]. Assignment has no effect when anisotropy is False.

property U13

The U[0, 2] element of the displacement tensor U, as a float

Sets U[2, 0] together with U[0, 2]. Assignment has no effect when anisotropy is False.

property U22

The U[1, 1] component of the displacement tensor U, as a float

When anisotropy is False setting a new value updates entire tensor U.

property U23

The U[1, 2] element of the displacement tensor U, as a float

Sets U[2, 1] together with U[1, 2]. Assignment has no effect when anisotropy is False.

property U33

The U[2, 2] component of the displacement tensor U, as a float

When anisotropy is False setting a new value updates entire tensor U.

property Uisoequiv

The isotropic displacement parameter or an equivalent value, as a float.

Setting a new value rescales tensor U so it yields equivalent direction-averaged displacements.

property anisotropy

The flag for allowing anisotropic displacement parameters, as a bool.

When False the tensor of thermal displacement parameters U must be isotropic and only its diagonal elements are taken into account.

element = ''

label = ''

lattice = None

msdCart(vc)

This function has been deprecated and will be removed in version 4.0.0.

Please use diffpy.structure.Atom.msd_cart instead.

msdLat(vl)

This function has been deprecated and will be removed in version 4.0.0.

Please use diffpy.structure.Atom.msd_latt instead.

msd_cart(vc)[source]

Calculate mean square displacement along the Cartesian vector.

Parameters:: vc (array_like) – Vector in Cartesian coordinates.
Returns:: The mean square displacement along vc.
Return type:: float

msd_latt(vl)[source]

Calculate mean square displacement along the lattice vector.

Parameters:: vl (array_like) – The vector in lattice coordinates.
Returns:: The mean square displacement along vl.
Return type:: float

occupancy = 1.0

property x: The fractional coordinate x, same as xyz[0], as a float

property xyz_cartn

Atom position in absolute Cartesian coordinates, as a numpy.ndarray.

This is computed from fractional coordinates xyz and the current lattice setup. Assignment to xyz_cartn or its components is applied on fractional coordinates xyz.

property y: The fractional coordinate y, same as xyz[1], as a float

property z: The fractional coordinate z, same as xyz[2], as a float

diffpy.structure.pdffitstructure module

Definition of PDFFitStructure class derived from Structure.

class diffpy.structure.pdffitstructure.PDFFitStructure(*args, **kwargs)[source]

Bases: Structure

PDFFitStructure –> Structure with extra pdffit member.

Parameters:

*args – See Structure class constructor.
**kwargs – See Structure class constructor.

pdffit

This stores the following extra parameters from PDFFit structure files:

‘scale’, ‘delta1’, ‘delta2’, ‘sratio’, ‘rcut’, ‘spcgr’, ‘dcell’, ‘ncell’

Type:: dict

read(filename, format='auto')[source]

Same as Structure.read, but update spcgr value in self.pdffit when parser can get spacegroup.

See Structure.read() for more info.

Parameters:

filename (str) – File to be loaded.
format (str, Optional) – All structure formats are defined in parsers submodule, when format == 'auto' all parsers are tried one by one.

Returns:

Instance of StructureParser used to load the data.

Return type:

StructureParser

readStr(s, format='auto')

‘diffpy.structure.PDFFitStructure.readStr’ is deprecated and will be removed in version 4.0.0.

Please use ‘diffpy.structure.PDFFitStructure.read_structure’ instead.

read_structure(s, format='auto')[source]

Same as Structure.read_structure, but update spcgr value in self.pdffit when parser can get spacegroup.

See Structure.read_structure() for more info.

Parameters:

s (str) – String with structure definition.
format (str, Optional) – All structure formats are defined in parsers submodule. When format == 'auto', all parsers are tried one by one.

Returns:

Instance of StructureParser used to load the data.

Return type:

StructureParser

diffpy.structure.sgtbxspacegroups module

Extra space group representations generated using sgtbx module from cctbx. Import of this module extends the SpaceGroupList in the SpaceGroups module.

diffpy.structure.sgtbxspacegroups.sgtbxSpaceGroupList

The list of space group instances defined in this module.

Type:: list