PlasmaCalcs.dimensions.dimension_tools.dimension_value.UniqueDimensionValue

class PlasmaCalcs.dimensions.dimension_tools.dimension_value.UniqueDimensionValue(name, repr=None, module_name=None, unique_includes_module=False)

Bases: Sentinel, SpecialDimensionValue

a unique dimension value, not corresponding to a usual value from a DimensionValueList.

E.g., INPUT_SNAP (defined in snaps.py) is the UniqueDimensionValue for the snap corresponding to the input deck.

Cannot provide any args or kwargs to __init__.

Equality with other dimension values only holds if the other value is a UniqueDimensionValue of the same type.

str(UniqueDimensionValue) will return the type name.

int(UniqueDimensionValue) will return None.

__init__(*args__None, **kw__None)

Methods

__init__(*args__None, **kw__None)
copy(**kw__None)
deserialize(serial)
equal_except_i(v)
from_dict(d)
getter(dlist)
lookup_dict()
register_type(cls_to_register[, ...])
serialize()
to_dict()
with_i(i)

Attributes

SERIAL_TYPES
i
ndim
s
size

copy(**kw__None)

return self; self is a Sentinel so there is only 1 instance.

static deserialize(serial)

creates an XarrayIoSerializable object from a serialized representation.

serial: dict or str

str –> convert to dict via ast.literal_eval.

dict must contain ‘typename’ key.

The output here will be an instance of XarrayIoSerializable.SERIAL_TYPES[typename]

equal_except_i(v)

returns whether self == v (another DimensionValue), ignoring i.

equal if v is an instance of type(self) and

all kw from both self._kw_eq and v._kw_eq have the same values.

(any kw missing attrs will be treated as UNSET.)

For DimensionValue: self.s==v.s and self.i==v.i. Subclasses may add more.

classmethod from_dict(d)

return cls from dict d.

If ‘d’ contains ‘typename’, result is like cls.deserialize(d) instead,

however, first require that result is an instance of cls (or subclass of cls).

E.g. Fluid.from_dict(dict(typename=’EppicDist’, …)) returns EppicDist,

but Snap.from_dict(dict(typename=’EppicDist’, …)) crashes with InputError.

Subclasses wishing to alter deserialize behavior will probably override this method instead.

getter(dlist)

get the value from dlist specified by self.

(Here, just returns self, the SpecialDimensionValue)

lookup_dict()

returns dict for looking up self within a DimensionValueList, given int, str, or self.

(used by DimensionValueList.lookup_dict)

static register_type(cls_to_register, _serial_typename=None)

register cls_to_register as a serializable subclass of XarrayIoSerializable.

_serial_typename: str or None

name to use for serialization. if None, use cls_to_register.__name__.

property s

alias to _name

serialize()

return dict of info about self, including ‘typename’ key.

to_dict()

return dictionary of info about self. Attribute values for keys in self._kw_def.

e.g. if _kw_def={‘s’, ‘i’}: result = {‘s’: self.s, ‘i’: self.i}

with_i(i)

return copy of self with i=i, or self if self.i==i already.