PickableObject
copick.models.PickableObject
Bases: BaseModel
Metadata for a pickable objects.
Attributes:
-
name(str) –Name of the object.
-
is_particle(bool) –Whether this object should be represented by points (True) or segmentation masks (False).
-
label(Optional[int]) –Numeric label/id for the object, as used in multilabel segmentation masks. Must be unique.
-
color(Optional[Tuple[int, int, int, int]]) –RGBA color for the object.
-
emdb_id(Optional[str]) –EMDB ID for the object.
-
pdb_id(Optional[str]) –PDB ID for the object.
-
identifier(Optional[str]) –Identifier for the object, drawn from an ontology/database namespace (GO, UniProtKB, CHEBI, PDB [dash separator, e.g.
PDB-1BXN], UBERON, CL, or CDPO). When using the data portal, this must match the annotationobject_idexactly. -
map_threshold(Optional[float]) –Threshold to apply to the map when rendering the isosurface.
-
radius(Optional[float]) –Radius of the particle, when displaying as a sphere. For a filament, the tube radius.
-
metadata(Optional[Dict[str, Any]]) –Additional metadata for the object (user-defined contents). The key
"copick"is reserved for copick's own extensions of the object spec;metadata["copick"]["filament"]declares the object a filament (seeFilamentSpec) and is validated when present.
filament
The filament declaration of this object, or None if it is not a filament.
validate_filament_spec
Validate and normalise metadata["copick"]["filament"] when it is present.
Only that key is checked: any other content of the metadata, including a non-dict value under
"copick" written before the key was reserved, is left as it is.
set_filament
Declare this object a filament, update its declaration, or remove it (filament=None).
Parameters:
-
filament(Union[FilamentSpec, Dict[str, Any], None]) –The filament spec, as a
FilamentSpecor a dict of its fields, or None.
Raises:
-
ValueError–If the spec is invalid, the object is not a particle, or
metadata["copick"]holds a non-dict value.