cellsystem.logging package

Subpackages

• cellsystem.logging.core package
  • Submodules
  • cellsystem.logging.core.log module
  • cellsystem.logging.core.multi module
  • cellsystem.logging.core.weak module
  • Module contents
    • Core logging classes

Submodules

cellsystem.logging.full module

class cellsystem.logging.full.FullLog(*args, **kwargs)

Bases: cellsystem.logging.core.multi.MultiLog

A log that records geometric information, mutations, ancestry and prints the actions to the screen.

Each part can be accesed with:

log[{{logname}}]

where {{logname}} can be one of: ‘geometry’, ‘mutations’, ‘ancestry’ or ‘printer’.

also, each log can be (de)activated with:

# Deactivate log
log[{{logname}}].silence()

# Rectivate log
log[{{logname}}].activate()

ancestry(prune_death=False)

Fetch information of the cells’ “family tree”.

mutations(prune_death=False)

Fetch information of the cells’ mutational history.

worldlines(prune_death=False)

Fetch information of the cells’ evolution in space and time.

cellsystem.logging.geometric module

Geometric Logging

This module defines functionality for following the geometric evolution of the cell blob through time.

The classes GeometricLog and WorldLines are defined here.

class cellsystem.logging.geometric.GeometricLog(*args, **kwargs)

Bases: cellsystem.logging.core.weak.WeakLog

Registers the geometric positions of the cells.

iter_changes()

Iterate through every action

iter_states()

Generate the intermediate states.

log_death(cell)

Register the disappeareance of the cell.

log_division(daughters)

log_migration(cell)

log_newcell(cell)

preparefor_division(cell)

worldlines(prune_death=False)

Get the geometric evolution of individual cells in space and time.

class cellsystem.logging.geometric.WorldLines(initial_state=None, time=0)

Bases: object

A class that represents the worldlines of a set of cells.

A worldline is the place in time and space that a cell occupies throughout it’s existence.

add_event(cell, event)

Add an event (a spacetime coordinate) for the cell.

classmethod from_log(geometric_log, prune_death=False)

Initialize from a geometric log.

last_state_of(cell)

Return the last recorded event of the given cell.

remove(cell)

Remove the given cell’s timeline.

show(div_marker='o', end_marker='', savefig=None)

Render the 3D worldlines as a plot.

update(state, transition, time, prune_death=False)

Add the event described by the transition, time and final state.

cellsystem.logging.simple module

cellsystem.logging.treelogs module

class cellsystem.logging.treelogs.AncestryLog(*args, **kwargs)

Bases: cellsystem.logging.treelogs.TreeLog

A tree log that maintains a “family tree”.

Each leaf represents a cell. When that cell divides, the leaf branches into leaves representing the daughters.

add_child(*args, **kwargs)

log_division(daughters)

Add 2 new branches to the father of the cells.

log_newcell(cell)

class cellsystem.logging.treelogs.MutationsLog(*args, **kwargs)

Bases: cellsystem.logging.treelogs.TreeLog

A tree log that maintains a record of genome branching events.

Each leaf represents a genome that may be present in one or more cells. When one of those cells mutates, the new genome is added as a child of that leaf.

log_division(daughters)

Remove the father from the alive cells.

log_mutation(cell)

Add a new child to the parent genome.

log_newcell(cell)

class cellsystem.logging.treelogs.TreeLog(*args, **kwargs)

Bases: cellsystem.logging.core.weak.WeakLog

Base class for logs that grow trees.

add_child(parent=None, name=None)

alive_nodes

fetch_tree(prune_death=False)

Fetch a copy of the tree.

If prune_death is True, remove the leaves that correspond to death cells.

log_death(cell)

preparefor_division(cell)

Module contents

Logging classes.

Classes related to the recording of the simulation progress, analysis and history.

class cellsystem.logging.FullLog(*args, **kwargs)

Bases: cellsystem.logging.core.multi.MultiLog

A log that records geometric information, mutations, ancestry and prints the actions to the screen.

Each part can be accesed with:

log[{{logname}}]

where {{logname}} can be one of: ‘geometry’, ‘mutations’, ‘ancestry’ or ‘printer’.

also, each log can be (de)activated with:

# Deactivate log
log[{{logname}}].silence()

# Rectivate log
log[{{logname}}].activate()

ancestry(prune_death=False)

Fetch information of the cells’ “family tree”.

mutations(prune_death=False)

Fetch information of the cells’ mutational history.

worldlines(prune_death=False)

Fetch information of the cells’ evolution in space and time.

class cellsystem.logging.PrinterLog(*args, **kwargs)

Bases: cellsystem.logging.core.log.Log

Simple logger that limits to print the action.

log_death(cell)

log_division(daughters)

log_migration(cell)

log_mutation(cell)

log_newcell(cell)

preparefor_death(cell)

preparefor_division(cell)

preparefor_migration(cell)

preparefor_mutation(cell)

class cellsystem.logging.MutationsLog(*args, **kwargs)

Bases: cellsystem.logging.treelogs.TreeLog

A tree log that maintains a record of genome branching events.

Each leaf represents a genome that may be present in one or more cells. When one of those cells mutates, the new genome is added as a child of that leaf.

log_division(daughters)

Remove the father from the alive cells.

log_mutation(cell)

Add a new child to the parent genome.

log_newcell(cell)

class cellsystem.logging.AncestryLog(*args, **kwargs)

Bases: cellsystem.logging.treelogs.TreeLog

A tree log that maintains a “family tree”.

Each leaf represents a cell. When that cell divides, the leaf branches into leaves representing the daughters.

add_child(*args, **kwargs)

log_division(daughters)

Add 2 new branches to the father of the cells.

log_newcell(cell)

class cellsystem.logging.GeometricLog(*args, **kwargs)

Bases: cellsystem.logging.core.weak.WeakLog

Registers the geometric positions of the cells.

iter_changes()

Iterate through every action

iter_states()

Generate the intermediate states.

log_death(cell)

Register the disappeareance of the cell.

log_division(daughters)

log_migration(cell)

log_newcell(cell)

preparefor_division(cell)

worldlines(prune_death=False)

Get the geometric evolution of individual cells in space and time.

cellsystem.logging.logged(action_name, prepare=True)

Decorate an action with logging.

Allows to specify if a prelogging action is called.