pdosSileSiesta

class sisl.io.siesta.pdosSileSiesta(filename, mode='r', comment=None, *args, **kwargs)

Bases: sisl.io.siesta.SileSiesta

Projected DOS file with orbital information

Data file containing the PDOS as calculated by Siesta.

Attributes

__dict__

__doc__

__module__

__weakref__

list of weak references to the object (if defined)

_write_default

_write_default_only

base_file

File of the current Sile

file

File of the current Sile

Methods

_ArgumentParser_args_single()

Default arguments for the Sile

__delattr__

Implement delattr(self, name).

__dir__

Default dir() implementation.

__enter__()

Opens the output file and returns it self

__eq__

Return self==value.

__exit__(type, value, traceback)

__format__

Default object formatter.

__ge__

Return self>=value.

__getattr__(name)

Override to check the handle

__getattribute__

Return getattr(self, name).

__gt__

Return self>value.

__hash__

Return hash(self).

__init__(filename[, mode, comment])

Initialize self.

__init_subclass__

This method is called when a class is subclassed.

__iter__()

Iterator for file

__le__

Return self<=value.

__lt__

Return self<value.

__ne__

Return self!=value.

__new__

Create and return a new object.

__reduce__

Helper for pickle.

__reduce_ex__

Helper for pickle.

__repr__

Return repr(self).

__setattr__

Implement setattr(self, name, value).

__sizeof__

Size of object in memory, in bytes.

__str__()

Return a representation of the Sile

__subclasshook__

Abstract classes can override this to customize issubclass().

_base_file(f)

Make f refer to the file with the appropriate base directory

_base_setup(*args, **kwargs)

Setup the Sile after initialization

_open()

_setup(*args, **kwargs)

Setup the Sile after initialization

_write(*args, **kwargs)

Wrapper to default the write statements

dir_file([filename])

File of the current Sile

exist()

Query whether the file exists

read(*args, **kwargs)

Generic read method which should be overloaded in child-classes

read_data([as_dataarray])

Returns data associated with the PDOS file

write(*args, **kwargs)

Generic write method which should be overloaded in child-classes

property base_file

File of the current Sile

dir_file(filename=None)

File of the current Sile

exist()

Query whether the file exists

property file

File of the current Sile

read(*args, **kwargs)

Generic read method which should be overloaded in child-classes

Parameters

kwargs – keyword arguments will try and search for the attribute read_<> and call it with the remaining **kwargs as arguments.

read_data(as_dataarray=False)[source]

Returns data associated with the PDOS file

For spin-polarized calculations the returned values are up/down, orbitals, energy. For non-collinear calculations the returned values are sum/x/y/z, orbitals, energy.

Parameters

as_dataarray (bool, optional) – If True the returned PDOS is a xarray.DataArray with energy, spin and orbital information as coordinates in the data. The geometry, unit and Fermi level are stored as attributes in the DataArray.

Returns

  • geom (Geometry instance with positions, atoms and orbitals.)

  • E (the energies at which the PDOS has been evaluated at (if Fermi-level present in file energies are shifted to \(E - E_F = 0\)).)

  • PDOS (an array of DOS with dimensions (nspin, geom.no, len(E)) (with different spin-components) or (geom.no, len(E)) (spin-symmetric).)

  • DataArray (if as_dataarray is True, only this data array is returned, in this case all data can be post-processed using the xarray selection routines.)

write(*args, **kwargs)

Generic write method which should be overloaded in child-classes

Parameters

**kwargs – keyword arguments will try and search for the attribute write_ and call it with the remaining **kwargs as arguments.