Conversion API provides access to MINERVA’s ability convert between different systems biology network formats and to export of layouts to different graphical formats.

1. Conversion to systems biology formats

1.1. List available formats

1.1.1. CURL sample

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/convert/' -X GET

1.1.2. Response Fields

Path Type Description

inputs

array

list of available input formats

inputs[].available_names

array<string>

list of names that could be used for specific format

outputs

array

list of available input formats

outputs[].available_names

array<string>

list of names that could be used for specific format

1.1.3. Sample Response

{
  "inputs" : [ {
    "available_names" : [ "CellDesigner_SBML", "lcsb.mapviewer.converter.model.celldesigner.CellDesignerXmlParser" ]
  }, {
    "available_names" : [ "SBGN-ML", "lcsb.mapviewer.converter.model.sbgnml.SbgnmlXmlConverter" ]
  }, {
    "available_names" : [ "SBML", "lcsb.mapviewer.converter.model.sbml.SbmlParser" ]
  }, {
    "available_names" : [ "GPML", "lcsb.mapviewer.wikipathway.GpmlParser" ]
  } ],
  "outputs" : [ {
    "available_names" : [ "CellDesigner_SBML", "lcsb.mapviewer.converter.model.celldesigner.CellDesignerXmlParser" ]
  }, {
    "available_names" : [ "SBGN-ML", "lcsb.mapviewer.converter.model.sbgnml.SbgnmlXmlConverter" ]
  }, {
    "available_names" : [ "SBML", "lcsb.mapviewer.converter.model.sbml.SbmlParser" ]
  }, {
    "available_names" : [ "GPML", "lcsb.mapviewer.wikipathway.GpmlParser" ]
  } ]
}

1.2. Convert network from an input format to an output format

1.2.1. CURL sample

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/convert/CellDesigner_SBML:GPML' -X POST \
    --data-binary @input_file.xml \
    -H 'Content-Type: text/plain'

1.2.2. Path Parameters

Table 1. /minerva/api/convert/{inputFormat}:{outputFormat}
Parameter Description

inputFormat

input format, available options: [CellDesigner_SBML, SBGN-ML, SBML, GPML]

outputFormat

output format, available options: [CellDesigner_SBML, SBGN-ML, SBML, GPML]

2. Convert network from an input format to an output image

2.1. List available formats

2.1.1. CURL sample

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/convert/image/' -X GET

2.1.2. Response Fields

Path Type Description

inputs

array

list of available input formats

inputs[].available_names

array<string>

list of names that could be used for specific format

outputs

array

list of available input formats

outputs[].available_names

array<string>

list of names that could be used for specific format

2.1.3. Sample Response

{
  "inputs" : [ {
    "available_names" : [ "CellDesigner_SBML", "lcsb.mapviewer.converter.model.celldesigner.CellDesignerXmlParser" ]
  }, {
    "available_names" : [ "SBGN-ML", "lcsb.mapviewer.converter.model.sbgnml.SbgnmlXmlConverter" ]
  }, {
    "available_names" : [ "SBML", "lcsb.mapviewer.converter.model.sbml.SbmlParser" ]
  }, {
    "available_names" : [ "GPML", "lcsb.mapviewer.wikipathway.GpmlParser" ]
  } ],
  "outputs" : [ {
    "available_names" : [ "png", "lcsb.mapviewer.converter.graphics.PngImageGenerator" ]
  }, {
    "available_names" : [ "pdf", "lcsb.mapviewer.converter.graphics.PdfImageGenerator" ]
  }, {
    "available_names" : [ "svg", "lcsb.mapviewer.converter.graphics.SvgImageGenerator" ]
  } ]
}

2.2. Convert network from an input format to an output image

2.2.1. CURL sample

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/convert/image/CellDesigner_SBML:png' -X POST \
    --data-binary @input_file.xml \
    -H 'Content-Type: application/octet-stream'

2.2.2. Path Parameters

Table 2. /minerva/api/convert/image/{inputFormat}:{outputFormat}
Parameter Description

inputFormat

input format, available options: [CellDesigner_SBML, SBGN-ML, SBML, GPML]

outputFormat

output format, available options: [png, pdf, svg]

3. Merging of maps

3.1. Merge

This API call allows to merge few files into one. Layout of merged map files will be a simple matrix. By default all notes are removed from maps (it’s impossible to merge them properly in formats like SBML/CellDesigner because there is one Species with the notes and alias to it in the whole diagram). Minerva can be asked to keep the notes by providing custom header "X-MINERVA-KEEP-NOTES: true", but the notes in output files might not be properly defined.

3.1.1. CURL sample

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/convert/merge/CellDesigner_SBML:CellDesigner_SBML' -X POST \
    --data-binary @maps.zip \
    -H 'Content-Type: application/octet-stream'

3.1.2. CURL sample 2

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/convert/merge/CellDesigner_SBML:CellDesigner_SBML' -X POST \
    -H 'X-MINERVA-KEEP-NOTES: true' \
    --data-binary @maps.zip \
    -H 'Content-Type: application/octet-stream'

3.1.3. Path Parameters

Table 3. /minerva/api/convert/merge/{inputFormat}:{outputFormat}
Parameter Description

inputFormat

input format, available options: [CellDesigner_SBML, SBGN-ML, SBML, GPML]

outputFormat

output format, available options: [CellDesigner_SBML, SBGN-ML, SBML, GPML]

3.1.4. Input file structure

Input file should be a zip file with single zip folder called "maps". All map files to merge should be located in this folder.