Troubleshooting

Verbose and debug output

Biopax2Cadbiom comes with a build feature that can outputs a lot of debug information when enabled.

Logs are stored in /tmp/biopax2cadbiom.log on GNU/Linux. By default the logging level outputs only warnings and errors, but the verbosity can be increased with a similar command:

$ biopax2cadbiom -vv debug ...

Conversion issues

Warnings and permanent nodes

During the conversion, some warnings with the following format can be generated:

WARNING: Reflexive transition: <ENTITY> -> <ENTITY> - This transition will not be taken into account.
Please review your model or use a PermanentNode instead.

This means that a transition reflects an autogeneration of an entity in the translated network. This is not usually supposed to happen and when the Cadbiom model is loaded, these transitions will not be interpreted.

During the development, these warnings help to solve and identify the unsupported cases of the BioPAX standard. However, in a release version, these are often inconsistencies in the BioPAX file. In the following you will find a number of real cases accompanied by explanations.


Inconsistencies in ModificationFeatures

Chibe screenshot modificationsFeatures

Screenshot of Chibe software; pathway IL27-mediated signaling events; file PathwayCommons9.pid.BIOPAX.owl available on http://pathwaycommons.org/.

The BiochemicalReaction (id BiochemicalReaction_029a73ec689684c3454a7ed939433f1d) defines the activation of a class named STAT1-3 (dimer) that contains two dimeric complexes: STAT1, STAT3 (ids: Complex_4db5f804f0956c670c3408800208ecd7, Complex_177aaa44ccf4e366dd236d4775e2f28c). However, each complexes already have a ModificationFeatures characterizing their activation. Therefore when decompiling classes, and applying their own modifications to their child entities, we obtain two auto-generating reactions for respectively STAT1__dimer__1a_v1 and STAT3__dimer___1a. The problem is that dimers should not have posttranslational modifications here.

Useless reaction 1

Chibe screenshot useless reactions

Screenshot of Chibe software; pathway Notch signaling pathway; file PathwayCommons9.pid.BIOPAX.owl available on http://pathwaycommons.org/.

Two reactions (ids BiochemicalReaction_eed7a51407246c4d87b70af25fc2f51b and BiochemicalReaction_1cea793964e781564918b8cf269d2f6d) have the same reactants and products with exactly the same attributes. Delta_1_1a -> Delta_1_1a and sDelta_1_1a -> sDelta_1_1a transitions are useless in the final model. Note that Chibe does not distinguish sDelta_1_1a and Delta_1_1a and displays the name of the gene instead (DLL1).

Useless reaction 2

Chibe screenshot useless reactions

Screenshot of Chibe software; pathway FAS (CD95) signaling pathway; reaction BiochemicalReaction_e119b10c1af4f3e8892e2b3f4e70eb1f; file PathwayCommons9.pid.BIOPAX.owl available on http://pathwaycommons.org/.

One reaction with the same Complex entity as reactant and product. The following transition will not be considered: FASLG_FAS__trimer__FADD_FADD_CASP8_CASP8_1a_integral_to_membrane_v2 -> FASLG_FAS__trimer__FADD_FADD_CASP8_CASP8_1a_integral_to_membrane_v2

Useless reaction 3

Chibe screenshot useless reactions

Screenshot of Chibe software; pathway Regulation of nuclear SMAD2/3 signaling; reaction BiochemicalReaction_751f22441b4e03560c7a85f39efbac35; file PathwayCommons9.pid.BIOPAX.owl available on http://pathwaycommons.org/.

One reaction with the same Complex entity as reactant and product. The following transition will not be considered: SMAD3_SMAD4_1a_nucleus -> SMAD3_SMAD4_1a_nucleus

Useless reaction 4

Chibe screenshot useless reactions

Screenshot of Chibe software; pathway Role of Calcineurin-dependent NFAT signaling in lymphocytes; reaction BiochemicalReaction_a66d82dae0ef3db5c6a50da02b372567; file PathwayCommons9.pid.BIOPAX.owl available on http://pathwaycommons.org/.

One reaction with the same Protein entity as reactant and product. The following transition will not be considered: NFAT1_1O_4O_1a_nucleus -> NFAT1_1O_4O_1a_nucleus

Useless reaction 5

Chibe screenshot useless reactions

Screenshot of Chibe software; pathway Canonical Wnt signaling pathway; reaction BiochemicalReaction_881effb0cf3e3124280b7844f03669cc; file PathwayCommons9.pid.BIOPAX.owl available on http://pathwaycommons.org/.

Two reactions with the same Complex entity as reactant and product. The following transition will not be considered: WNT3A_LRP6_FZD5_DVL_1a_integral_to_membrane_v2 -> WNT3A_LRP6_FZD5_DVL_1a_integral_to_membrane_v2

Useless reaction 6

Chibe screenshot useless reactions

Screenshot of Chibe software; pathway Noncanonical Wnt signaling pathway; reaction BiochemicalReaction_23d1312ee8c92c4d5434cdc3f0985741; file PathwayCommons9.pid.BIOPAX.owl available on http://pathwaycommons.org/.

DVL2_1a is a self-generating class. One of its child entities is reused elsewhere in the model (we see one of these reactions at the bottom of the screenshot: DVL2 -> ?). A similar case is tested in virtualCase10c.

Unsupported interactions

There may be errors related to the translation of some interactions defined in the BioPAX formalism.

Omitted reactions

Type of reaction is deliberately unsupported because it is too imprecise: <BIOPAX_URI>

According to the BioPAX standard [1], MolecularInteractions are produced by high throughput systems that does not satisfy the level of detail (i.e. enough experimental evidence) required to model them with ComplexAssembly class. These interactions will not be translated.

chibe screenshot MolecularInteraction

Screenshot of Chibe software; pathway N-Glycan biosynthesis; file PathwayCommons10.kegg.BIOPAX.owl available on http://pathwaycommons.org/.

We can see two MolecularInteractions between ALG3 and ALG9, and between ALG9 and ALG13.

Unexpected reactions

UNEXCEPTED REACTION: <BIOPAX_URI>

During the development of Biopax2Cadbiom, we have never encountered this type of interaction in the databases used. These interactions will not be translated.

Footnotes

[1]BioPAX – Biological Pathways Exchange Language - Level 3, Release Version 1 Documentation, 2010. Available: http://www.biopax.org/release/biopax-level3.owl