kisao 2.34

Installing this package

pip install kisao

pip install kisao[substitutability-matrix]

Tutorial

from kisao import Kisao
from kisao import utils
from kisao.data_model import AlgorithmSubstitutionPolicy

# load the ontology
kisao = Kisao()

# get a term
term = kisao.get_term('KISAO_0000019')

# get the name of the term
term.name
>> 'CVODE'

# get sets of methods
algs = utils.get_ode_algorithms()
sorted([alg.name for alg in algs])[0:5]
>> [
      'Adams method',
      'Adams predictor-corrector method',
      'Adams-Bashforth method',
      'Adams-Moulton method',
      'Bader-Deuflhard method',
   ]

algs = utils.get_sde_algorithms()
algs = utils.get_pde_algorithms()
algs = utils.get_tau_leaping_algorithms()
algs = utils.get_ode_algorithms()
algs = utils.get_gillespie_like_algorithms()
algs = utils.get_tau_leaping_algorithms()
algs = utils.get_rule_based_algorithms()
algs = utils.get_sde_algorithms()
algs = utils.get_pde_algorithms()
algs = utils.get_flux_balance_algorithms()
algs = utils.get_logical_algorithms()
algs = utils.get_hybrid_algorithms()

# get a set of substitutable algorithms for a specific substitution policy
cvode = kisao.get_term('KISAO_0000019')
euler_forward = kisao.get_term('KISAO_0000030')
lsoda = kisao.get_term('KISAO_0000088')
lsodar = kisao.get_term('KISAO_0000089')
fba = kisao.get_term('KISAO_0000437')
fva = kisao.get_term('KISAO_0000526')

alt_algs = utils.get_substitutable_algorithms_for_policy(cvode,
    substitution_policy=AlgorithmSubstitutionPolicy.SIMILAR_APPROXIMATIONS)
sorted([alt_alg.name for alt_alg in alt_algs])[0:5]
>> [
      'Adams method',
      'Adams predictor-corrector method',
      'Adams-Bashforth method',
      'Adams-Moulton method',
      'Bader-Deuflhard method',
   ]

# get a preferred substitution for an algorithm
requested_alg = lsoda
implemented_algs_in_preferred_order = [cvode, lsoda, lsodar, euler_forward]
alt_alg = utils.get_preferred_substitute_algorithm(requested_alg, implemented_algs_in_preferred_order,
    substitution_policy=AlgorithmSubstitutionPolicy.SIMILAR_APPROXIMATIONS)
alt_alg.name
>> 'LSODA'

requested_alg = lsoda
implemented_algs_in_preferred_order = [cvode, euler_forward]
alt_alg = utils.get_preferred_substitute_algorithm(requested_alg, implemented_algs_in_preferred_order,
    substitution_policy=AlgorithmSubstitutionPolicy.SIMILAR_APPROXIMATIONS)
alt_alg.name
>> 'CVODE'

requested_alg = lsoda
implemented_algs_in_preferred_order = [fba, fva]
alt_alg = utils.get_preferred_substitute_algorithm(requested_alg, implemented_algs_in_preferred_order,
    substitution_policy=AlgorithmSubstitutionPolicy.SIMILAR_APPROXIMATIONS)
alt_alg
>> None

Browsing KiSAO

KiSAO can be browsed through BioPortal and OLS.

Browsing the substitutability of algorithms catalogued by KiSAO

A matrix of the substitutability of algorithms catalogued by KiSAO is available here. The documentation for this package describes the queries and rules used to define this matrix.

Contributing to KiSAO

Please see the KiSAO repository for information about contributing to KiSAO and this package.

License

This package is released under Artistic License 2.0.