BinaryCIFCategory#

class biotite.structure.io.pdbx.BinaryCIFCategory(columns=None, row_count=None)[source]#

Bases: _HierarchicalContainer

This class represents a category in a BinaryCIFBlock.

Columns can be accessed and modified like a dictionary. The values are BinaryCIFColumn objects.

Parameters:
columnsdict, optional

The columns of the category. The keys are the column names and the values are the BinaryCIFColumn objects (or objects that can be coerced into a BinaryCIFColumn). By default, an empty category is created. Each column must have the same length.

Examples

>>> # Add column on creation
>>> category = BinaryCIFCategory({"fruit": ["apple", "banana"]})
>>> # Add column later on
>>> category["taste"] = ["delicious", "tasty"]
>>> # Add column the formal way
>>> category["color"] = BinaryCIFColumn(BinaryCIFData(["red", "yellow"]))
>>> # Access a column
>>> print(category["fruit"].as_array())
['apple' 'banana']
Attributes:
row_countint

The number of rows in the category, i.e. the length of each column.

static deserialize(content)#

Create this component by deserializing the given content.

Parameters:
contentstr or dict

The content to be deserialized. The type of this parameter depends on the file format. In case of CIF files, this is the text of the lines that represent this component. In case of BinaryCIF files, this is a dictionary parsed from the MessagePack data.

serialize()#

Convert this component into a Python object that can be written to a file.

Returns:
contentstr or dict

The content to be serialized. The type of this return value depends on the file format. In case of CIF files, this is the text of the lines that represent this component. In case of BinaryCIF files, this is a dictionary that can be encoded into MessagePack.

static subcomponent_class()#

Get the class of the components that are stored in this component.

Returns:
subcomponent_classtype

The class of the subcomponent. If this component already represents the lowest level, i.e. it does not contain subcomponents, None is returned.

static supercomponent_class()#

Get the class of the component that contains this component.

Returns:
supercomponent_classtype

The class of the supercomponent. If this component present already the highest level, i.e. it is not contained in another component, None is returned.