From cb8db7594618558dd177646a38d6e52f2ef30e5e Mon Sep 17 00:00:00 2001 From: marco <marco@5a81b35b-ba03-0410-adc8-b2c5c5119f08> Date: Wed, 7 Jul 2010 10:10:31 +0000 Subject: [PATCH] update docs git-svn-id: https://dng.biozentrum.unibas.ch/svn/openstructure/trunk@2538 5a81b35b-ba03-0410-adc8-b2c5c5119f08 --- modules/base/doc/generic.rst | 6 ++++ modules/doc/intro-03.rst | 4 +-- modules/gfx/doc/entity.rst | 15 +++++++++ modules/mol/base/doc/entity.rst | 60 ++++++++++++++++++++++----------- 4 files changed, 63 insertions(+), 22 deletions(-) diff --git a/modules/base/doc/generic.rst b/modules/base/doc/generic.rst index 03ed133b5..e24ca06b9 100644 --- a/modules/base/doc/generic.rst +++ b/modules/base/doc/generic.rst @@ -159,4 +159,10 @@ API documentation .. method:: SetBoolProp(key, value) Set bool property, overriding a property with the same name + + .. method:: RemoveProp(key) + + Removes the property with given key, regardless of its type. If the property + does not exist, the method has no effect. + diff --git a/modules/doc/intro-03.rst b/modules/doc/intro-03.rst index 5a6fc08aa..c2d6713d7 100644 --- a/modules/doc/intro-03.rst +++ b/modules/doc/intro-03.rst @@ -23,7 +23,7 @@ of data. The last command is not mandatory, but very convenient to center the camera on the object. -The :class:`~ost.gfx.Scene` +The Scene -------------------------------------------------------------------------------- @@ -57,7 +57,7 @@ manipulated: The last command assigns a uniform red coloring to all atoms. -The :class:`Graphical Entity <ost.gfx.Entity>` +The Graphical Entity -------------------------------------------------------------------------------- Now let's look at the graphical entity in more detail. The graphical entity is diff --git a/modules/gfx/doc/entity.rst b/modules/gfx/doc/entity.rst index a3bf16719..4ebe5f7d8 100644 --- a/modules/gfx/doc/entity.rst +++ b/modules/gfx/doc/entity.rst @@ -100,11 +100,26 @@ Render Options Defaults to off. :type: bool + + + **bond_order_distance** The distance between the lines depicting higher order bonds. + +Loading and Displaying an Entity +-------------------------------------------------------------------------------- + +This code examples shows how to load a structure and display it on the screen. It also shows how to programmatically combine different render modes in one graphical entity. + +.. literalinclude:: /../../examples/demos/load_and_display.py + + +Entity API Reference +-------------------------------------------------------------------------------- + .. class:: Entity(name, entity) Entity(name, render_mode, entity) diff --git a/modules/mol/base/doc/entity.rst b/modules/mol/base/doc/entity.rst index 8aa95e6a8..0280c9a23 100644 --- a/modules/mol/base/doc/entity.rst +++ b/modules/mol/base/doc/entity.rst @@ -65,7 +65,13 @@ The Handle Classes This property is read-only. Also available as :meth:`GetAtomList` :type: A list of :class:`atom handles<AtomHandle>` - + + .. attribute:: bounds + + Axis-aligned bounding box of the entity. Read-only + + :type: :class:`ost.geom.AlignedCuboid` + .. attribute:: mass The total mass of the entity in Dalton. Also available as :meth:`GetMass`. @@ -322,7 +328,13 @@ The Handle Classes This property is read-only. Also available as :meth:`GetAtomList` :type: A list of :class:`atom handles<AtomHandle>` - + + .. attribute:: bounds + + Axis-aligned bounding box of the chain. Read-only + + :type: :class:`ost.geom.AlignedCuboid` + .. attribute:: mass The total mass of this chain in Dalton. Also available as :meth:`GetMass` @@ -425,6 +437,12 @@ The Handle Classes :type: str + .. attribute:: bounds + + Axis-aligned bounding box of the residue. Read-only. + + :type: :class:`ost.geom.AlignedCuboid` + .. attribute:: mass The total mass of this residue in Dalton. Also available as :meth:`GetMass`. @@ -774,6 +792,12 @@ The View Classes :type: A list of :class:`AtomViews <AtomView>` + .. attribute:: bounds + + Axis-aligned bounding box of the entity view. Read-only. + + :type: :class:`ost.geom.AlignedCuboid` + .. attribute:: handle The underlying :class:`handle <EntityHandle>` of the entity view. Also @@ -906,7 +930,7 @@ The View Classes :param residue: Residue handle :type residue: ResidueHandle - :returns: The residue view pointing the the handle, or an invalid handle if the residue is not part of the view + :returns: The residue view pointing the the handle, or an invalid handle if the residue is not part of the view :rtype: class:`ResidueView` .. method:: FindAtom(chain_name, res_num, atom_name) @@ -1101,7 +1125,13 @@ The View Classes This property is read-only. Also available as :meth:`GetAtomList` :type: A list of :class:`atom handles<AtomHandle>` - + + .. attribute:: bounds + + Axis-aligned bounding box of the chain. Read-only + + :type: :class:`ost.geom.AlignedCuboid` + .. attribute:: mass The total mass of this chain in Dalton. Also available as :meth:`GetMass` @@ -1258,14 +1288,6 @@ The View Classes :type flags: int :rtype: :class:`EntityView` - .. method:: Apply(visitor) - - Apply entity visitor to view. In Python, you usually don't have to use this - method. - - :param visitor: The visitor - :type visitor: :class:`EntityVisitor` - .. class:: ResidueView .. attribute:: name @@ -1302,6 +1324,12 @@ The View Classes :type: str + .. attribute:: bounds + + Axis-aligned bounding box of the residue view. Read-only + + :type: :class:`ost.geom.AlignedCuboid` + .. attribute:: mass The total mass of this residue in Dalton. Also available as :meth:`GetMass`. @@ -1400,14 +1428,6 @@ The View Classes .. method:: GetAtomList() See :attr:`atoms` - - .. method:: Apply(visitor) - - Apply entity visitor to the residue. In Python, you don't have to use this - method. Is is mainly used in C++. - - :param visitor: - :type visitor: :class:`EntityVisitor` .. method:: Select(query[, flags]) -- GitLab