BACKGROUND
understanding the structure and dynamics of biological systems has been a major task in systems biology  <cit> .
in the early years of computational biology, the main task was to investigate the individual properties of intracellular components and collect this information in large databases  <cit> .
palsson defines biological systems as interactions of their components  <cit> .
furthermore, the development of high-throughput technologies made it possible to study these complex systems in a quantitative manner  <cit> .
moreover, gene networks, whose nodes represent gene products and the edges correspond to molecular interactions, serve as means to study the biological function by representing and analyzing high-throughput data  <cit> .
network inference plays a major role in network biology, as there exist various methods to infer networks from high-throughput data  <cit> .
by using the wgcna package  <cit>  it is possible to create correlation networks.
one can use the minet package  <cit>  to infer networks based on mutual information.
other packages  <cit>  offer methods to infer networks using different kinds of graphical models.
moreover, altay and emmert-streib introduced the c3net algorithm to infer the conservative causal core of gene networks and compared them to other approaches  <cit> .
their study shows the importance of correctly creating robust and valid networks from biological data.
note that it is crucial to choose suitable methods for inferring networks from biological data, in order to take the nature and constraints of the underlying problem into account  <cit> .
after inferring gene networks, it is often important to analyze them structurally to conclude statements about the underlying topology  <cit> .
moreover, the structural analysis of biological networks can be useful to extract biological knowledge that may not be revealed by studying the raw data  <cit> .
typical problems aim at identifying of topological interesting nodes or characterizing the networks by means of their structure.
therefore, we provide an r package called quacn  <cit>  providing a selection of new topological network descriptors.
such descriptors are numerical graph invariants that quantitatively characterize the structure of the underlying network.
note, that the authors use the words descriptor, measure, or index as synonym for topological network descriptors.
quantifying the complexity of networks appears in different scientific disciplines and has been a challenging research topic during the last decades  <cit> .
importantly, little is known about the structural interpretation of topological network descriptors  <cit> .
this relates to information-theoretic measures  <cit>  that had been used to determine the entropy of the graph topology.
other topological network descriptors had been used also in mathematical and medical chemistry including drug design to analyze and characterize the structure of chemical compounds   <cit> .
in more biologically motivated work, xia et al.
<cit>  used the vertex degree of protein-protein interaction  networks to correlate the structural complexity of proteins and the organismal complexity with the complexity of the underlying ppi network.
they show that the ppi domain coverage significantly correlates with the vertex degrees of the ppi networks  <cit> .
in another study, mazurie et al.
<cit>  used different network measures to link the structure and complexity of metabolic reactions  to the phylogeny of species.
their results show that a small set of descriptors reproduces the phylogenetic distances accurately  <cit> .
numerous network measures have been developed, but it would be out of the scope of this paper to explain them in detail.
for further investigation see the recently and up to date review due to dehmer and mowshowitz  <cit> .
apart from information-theoretic measures, todeschini et al.
<cit>  provides a compelling overview of available network descriptors.
but from  <cit> , the feasibility and properties of a large number of descriptors remain untackled.
quacn provides a selection of topological network descriptors.
it offers the possibility to apply the indices in a standardized and intuitive manner.
thus, it can support the scientific community to investigate these methods in different kinds of biological applications.
a typical setup for a study to analyze biological networks structurally is illustrated in figure  <dig>  it shows a general workflow to analyze microarray studies using a network approach with topological network measures.
of course, there also exist freely available tools, e.g., powermv  <cit>  or joelib  <cit>  to calculate network descriptors.
however, these tools are designed for quantitative structure-activity relationship .
thus, they do not support common exchange standards for biological data.
compared to commercial software tools as dragon  <cit>  or preadmet  <cit> , quacn is published under an open source license  and freely available.
therefore, it offers the possibility to adjust and further develop the existing indices or even add additional descriptors to the package.
compared to the r-packages igraph  <cit>  and rbgl  <cit> , which contain a few basic descriptors, quacn contains a selection of more sophisticated network descriptors .
to our best knowledge, it is the only available software package that contains sophisticated measures such as the parametric graph entropies   <cit> .
we recommend quacn to investigate large-scale complex networks.
further, we expect that the package will be helpful for exploring questions concerning the structure of biological networks in the context of systems biology.
generally, quantitative network analysis  <cit>  is a non-trivial task, since it is necessary to understand the methods in detail to interpret the results correctly.
this manuscript addresses readers who want to analyze networks structurally.
its aim is to guide the reader to correctly apply the methods provided by quacn  <cit> .
this manuscript does not deal with the issue of inferring robust and valid networks.
neither does it explain the network measures in detail nor how to interpret the results of the topological networks descriptors, as this would go beyond the scope of this paper.
dehmer et al.
dealt with these questions extensively  <cit> .
this paper is structured as follows: the section implementation gives an overview about the topological network descriptors, implemented in the r-package quacn.
the section results and discussion illustrates how to apply the topological descriptors to concrete networks.
also, we show the behavior of selected measures using small example graphs.
moreover, we demonstrate their performance by applying them to biological networks.
further, we illustrate possible use cases using topological network descriptors for performing a quantitative analysis of biological networks.
the section summary and outlook concludes and summarizes the paper and outlines future developments.
implementation
we implemented a selection of topological network descriptors discussed in  <cit> .
table  <dig> gives an overview about all implemented network measures with the name of the function to call the corresponding descriptors in r. for a detailed description of all implemented descriptors in quacn, see the package vignette or additional literature  <cit> .
this table gives an overview about the implemented topological network descriptor including the function name in quacn and the reference to the corresponding publication.
the measures can be categorized within the following groups:
descriptors based on distances in a graph
this class contains measures that use distances between nodes to capture the structural complexity of the underlying network.
a famous and classical representative of this group is the wiener index  <cit>  that has been defined by the sum of all distances within the network.
we also integrated a group of basic distance-based descriptors introduced by skorobogatov and dobrynin  <cit> .
descriptors based on other graph invariants
the descriptors in this class use other graph invariants than distances  to characterize the structural complexity of complex biological networks.
for example, the zagreb group indices  <cit>  are based on the degree of the vertices.
the normalized edge complexity  <cit>  is calculated by using the adjacency matrix and the number of vertices.
information measures
for an extensive overview of measures of this class, see  <cit> .
• partition-based graph entropy descriptors
these measures use an arbitrary graph invariant and an equivalence criteria to induce partitions.
a probability value is calculated for each partition to determine the entropy, based on the entropy formula due to shannon  <cit> .
the topological information content introduced by rashevsky  <cit>  and reformulated by trucco  <cit>  is based on partitions of vertices that are in the same vertex orbit, to calculate the entropy of a graph.
additionally, mowshowitz  <cit>  investigated mathematical properties of the index to characterize product graphs and other sophisticated measures such as the chromatic information content of a graph.
• parametric graph entropy measures
measures of this class  <cit>  assign a probability value to each vertex of a graph, using so-called information functionals  which capture structural information of the network.
a special information functional quantifies the structural information by using the cardinalities of the corresponding j-spheres  <cit> .
the derived probability distribution is used to calculate the entropy, which has been called dehmer entropy  <cit> .
as mentioned above, it is not the aim of this manuscript to describe all descriptors in detail.
for a better understanding of the used descriptors see the vignette of quacn and the extensive work of dehmer and mowshowitz  <cit>  on information measures for networks.
quacn is entirely written in r and detailed help is available according to the r documentation standards.
RESULTS
the examples below show the functionality of quacn by using a selection of small example graphs, which are shown by figure  <dig>  our goal is to show how the methods work and to apply the measures to a multitude of complex networks that may lead to novel applications in the field.
example graphs
to demonstrate the usefulness of topological network descriptors, we consider figure  <dig>  showing six undirected example graphs.
an undirected graph or network g =  consists of a non-empty vertex set v. e is called the edge set of g and is the set of unordered pairs of elements of v. we calculate exemplary a set of descriptors consisting of the wiener index w  <cit> , the balaban-like index x  <cit> , the topological information content iorb  <cit>  and the dehmer entropy ifv   <cit> .
the results are shown in table  <dig>
results of some selected descriptors applied to the small example graphs shown in figure  <dig>
calling the corresponding methods in r can be done in different ways.
the following example shows how to calculate the wiener index from the graphnel-object g, representing the example graph  in figure  <dig>
> wiener
<cit> 56
as all descriptors are implemented as r-functions it is possible to easily calculate them for a set of graphs using the methods from the apply-family.
> sapply
<dig>   <dig>   <dig>
<dig>   <dig>   <dig>
note that each descriptor has at least two parameters as listed in table  <dig>  however, passing the distance matrix to the corresponding function is optional.
if the parameter remains empty or is set to null the distance matrix will be calculated within each function.
if calculating more than one descriptor for one graph, it is recommended to calculate the distance matrix separately and pass it to each method, instead of recalculating it again.
particularly when using large networks it can save a lot of time to calculate the distance matrix only once.
it will enhance the performance of the calculations significantly.
we demonstrate the pre-calculation of the distance matrix in the next example, where we calculate four descriptors for the example graphs in figure  <dig>  the results of the below listed function call are listed in table  <dig>
this table shows the two parameters that are common for every method.
> descriptors <- sapply{
+    dm <- distancematrix
+    result = list()
+    result] <- wiener
+    result] <- balabanlike2
+    result] <-
+       topologicalinfocontent$iorb
+    result] <-
+       infotheoreticgcm$entropy
+    return
+ })
calling topological information content  <cit>  and the dehmer entropy  <cit>  returns a list of different variables.
in the example we only use the entropy value of the descriptor.
the call of the function works like all other methods, but it returns a list of different values.
to explain the result of this function we apply it to graph  in figure 2:
> topologicalinfocontent
$entropy
<cit>  <dig>
$orbits
<cit>  <dig>  <dig> 1
the implementation of the topological information content returns a list containing the entropy  and the number of nodes within the same orbit .
this information can be used for different other applications, e.g.
to determine a graph prototype, see  <cit> .
the numerical results of the foregoing example can be seen in table  <dig>  the visual representation of the normalized results in figure  <dig> shows the different behavior of the topological network descriptors using the example graphs.
the example graphs start with a linear graph  and the branching of the graphs increases towards .
in this context, branching correlates with the number of terminal vertices   <cit> .
the wiener index is known as an index to detect molecular branching  <cit> , and one can see that the wiener index represents increasing branching with decreasing values.
furthermore we can see in this example, that the balaban-like index x also detects branching well.
note, that its values are just given in a reverse order.
the topological information content is based on partitions of vertices that are in the same vertex orbit.
but calculating iorb shows that the quantity does not reflect branching properly.
as known, iorb is a symmetry-based measure rather than an index for structural complexity  <cit> .
in this example, the dehmer entropy with monotonously decreasing weighting parameter ci and the information functional using the j-spheres, neither reflects branching appropriately.
the information functional using the j-spheres  <cit>  itself has been used to investigate the information spread in a network  <cit> .
however, with a different parameter setting, the dehmer entropy reflects branching of certain networks meaningfully  <cit> .
however, this simple but demonstrative example indicates that not every topological information index is suitable for a particular problem.
it is a challenging task to derive general statements about the structural complexity captured by such measures  <cit> .
it is even harder to connect biological properties with topological network descriptors.
despite the fact that we often do not know the biological interpretation of topological network measures exactly, they can be helpful in a broad range of biological questions.
for example, classifying biological data or identifying meaningful biological features, by analyzing the topology of biological networks.
to conclude this section, we want to emphasize that one has to understand the selected descriptors and measures in detail to interpret the results correctly.
note that topological network analysis is a non-trivial task and one has to know specific properties of the descriptors to solve a particular problem dealing with networks.
one example is the group of balaban-like indices x and u. for a graph with two vertices connected with one edge the index is defined as infinite.
that is also returned by the quacn-method but accompanied by a warning:
> g = new
> # add nodes
> g = addnode
> g = addnode
> g = addedge
> balabanlike1
<cit> inf
warning message:
in balabanlike1: graphs with
|v| <  <dig> result in: inf!
it is important to know how the different descriptors are defined, when processing and interpreting the results.
note, that not each combination of networks and descriptors could be tested and considered within the exception handling.
keep in mind that applying quacn to concrete networks can result in special values , not available  or not a number ).
the next section shows an example of a possible application of quacn with biological networks.
we will also use this chapters to explain the usage of more complex descriptors implemented in quacn.
supervised machine learning for prostate cancer networks
in this section, we present an application of topological network descriptors to classify gene networks inferred from gene expression data.
note, we do not aim to justify network-based approaches itself and compare them to alternative approaches.
in fact, a large body of literature dealing with networks does exist, i.e., see  <cit> .
this example was chosen to explain a possible application of topological network descriptors on biological data.
therefore, we will focus on the methodical usage of the network measures and not on the biological interpretation of the results.
to perform our analysis, we selected seven public available studies of prostate cancer from ncbi geo and ebi arrayexpress and inferred networks using the c3net inference method  <cit> .
this resulted in seven networks {gib}i= <dig> representing benign tissue  and seven networks {gic}i= <dig> representing cancer tissue.
then we extracted subgraphs from these networks based on the gene ontology  database  <cit> .
for each network and each go-term we extracted one subgraph containing the genes associated with this specific go-term.
this resulted in a total of  <dig> networks representing benign tissue and  <dig> networks representing cancer tissue.
the numbers are different because the network structure of gib and gic is different and, hence, not all pathways are captured by these networks.
whenever a subnetwork contained less than  <dig> genes associated with a go-term, we excluded this pathway from the analysis.
the obtained network sets can be seen as an approximation of two populations.
one population represents benign and the second cancerous molecular interactions.
additionally, we calculated all topological network descriptors available in quacn, as feature vectors for each of these networks.
afterwards, we performed feature selection and classification using random forest with 10-fold cross-validation .
in order to correct the selection bias, an external cross validation is applied to the selection process  <cit> .
in particular, we performed the selection process within each cv-loop  <cit> .
we trained the classifier to classify cancer networks versus benign networks, what lead to a mean classification performance of a f-score of  <dig>  and an accuracy of  <dig> .
this demonstrates that the topological network descriptors, integrated in quacn, are able to capture group specific structural features meaningfully to distinguish between networks representing prostate cancer and benign tissue.
importantly, this result is not trivial as one could easily show by using other measures or only a particular fraction thereof, the classification task would result in a random classification.
hence, this result would not be feasible in practice.
as already mentioned we won't focus on a biological representation of the results, as it is the aim of this publication to discuss the methodical perspective of the presented r-package.
one of the measures that showed a significant group effect was the dehmer entropy  <cit> .
the dehmer entropy is a complex measure with several parameters.
it is possible to choose the information functional f, the weighting parameter ci and the scaling constant λ  <cit> .
the means of these parameters has been discussed in  <cit> .
the user can specify four different information functionals using j-spheres, path lengths, vertex centrality or degree-degree associations  <cit> .
we implemented different pre-settings for the weighting parameter ci: constant, linear, quadratic or exponential.
a customized setting for ci can also be declared.
the following example shows how to call the function to calculate a dehmer entropy.
the information functional using j-spheres with an exponential setting for ci and a scaling constant λ =  <dig> are used.
> infotheoreticgcm
$entropy
<cit>  <dig>
$distance
<cit>  <dig>
$pis
<dig>  <dig>  <dig> 4
<dig>   <dig>   <dig>   <dig>
<dig>  <dig> 7
<dig>   <dig>   <dig>
$fvis
<dig>  <dig>  <dig> 4
<dig>   <dig>   <dig>   <dig>
<dig>  <dig> 7
<dig>   <dig>   <dig>
this function returns a list containing a more comprehensive result than the other measures.
certainly, the list contains the dehmer entropy denoted by $entropy.
the list entry named $distance contains the distance of the entropy from maximum entropy  <cit> .
it also returns the results of calculating the information functional  and the corresponding probability distribution .
the probability distribution can later be used for further analysis, i.e.
estimating the graph prototype of a set of networks  <cit> .
CONCLUSIONS
the freely available open source r-package quacn contains a selection of topological network descriptors.
the aim of this manuscript was to explain, how to apply the implemented descriptors correctly to complex biological networks using r. to provide a basic understanding of the application we demonstrated the behavior of the indices by applying them to small example networks.
moreover, we presented an application for supervised machine learning from biological networks by using topological network descriptors.
within these examples we demonstrated the correct usage of the methods included in quacn.
machine learning is not the only application that topological network descriptors can be used for.
they also can be utilized to compare networks.
in this sense, kugler et.
al.
<cit>  calculated the kullback-leibler divergence to perform an integrative network analysis.
topological network descriptors have been standard methods in the field of quantitative structure property activity relationship   <cit> .
the methods implemented in quacn had already been used for qsar/qspr applications, see  <cit> .
further applications of information-theoretic measures had been discussed by dehmer and mowshowitz  <cit> .
the indices integrated in quacn can also be efficiently applied on large networks as their calculation requires polynomial time complexity.
however, there also exist some indices whose algorithms are np-complete , but they have not been integrated in the package.
importantly, not every index is suitable for any application in network biology and it strongly depends on the underlying research question which measures can be considered as appropriate.
using the concept of advanced network descriptors is relatively new in systems biology.
advanced network descriptors are able to quantify specific topological characteristics of the underlying network but the interpretation of the structural properties of the applied measures is still an ongoing task  <cit> .
however, modeling biological systems as networks had become an important task in recent systems biology research and created a need for methods to analyze them structurally.
therefore, the topological network measures provided by quacn can stimulate the research in this field.
however, a thorough analysis to investigate the behavior of topological information indices on biological networks is planed to be performed.
as future work, we plan to apply the integrated measures on various biological research questions, and to extend the range of functions with new promising descriptors for coming versions of quacn.
the next step is to integrate a group of already existing polynomial-based descriptors  <cit> .
finally, we are convinced that this package will turn out to be useful for a community dealing with network biology  <cit> .
availability and requirements
project name: quacn - quantitative analysis of complex networks
project home page: http://cran.r-project.org/web/packages/quacn/
operating system: platform independent
programming language: r
license: lgpl
competing interests
the authors declare that they have no competing interests.
authors' contributions
lajm and kgk implemented and tested the r-package, performed the analysis and interpreted the results.
lajm, kgk, ag, fes and md and wrote the manuscript.
md supervised the study.
all authors read and approved the final manuscript.

 understanding the structure and dynamics of biological systems has been a major task in systems biology. in the early years of computational biology, the main task was to investigate the individual properties of intracellular components and collect this information in large databases. palsson defines biological systems as interactions of their components. furthermore, the development of high-throughput technologies made it possible to study these complex systems in a quantitative manner. moreover, gene networks, whose nodes represent gene products and the edges correspond to molecular interactions, serve as means to study the biological function by representing and analyzing high-throughput data. network inference plays a major role in network biology, as there exist various methods to infer networks from high-throughput data. by using the wgcna package it is possible to create correlation networks. one can use the minet package to infer networks based on mutual information. other packages offer methods to infer networks using different kinds of graphical models. moreover, altay and emmert-streib introduced the c3net algorithm to infer the conservative causal core of gene networks and compared them to other approaches. their study shows the importance of correctly creating robust and valid networks from biological data. note that it is crucial to choose suitable methods for inferring networks from biological data, in order to take the nature and constraints of the underlying problem into account. after inferring gene networks, it is often important to analyze them structurally to conclude statements about the underlying topology. moreover, the structural analysis of biological networks can be useful to extract biological knowledge that may not be revealed by studying the raw data. typical problems aim at identifying of topological interesting nodes or characterizing the networks by means of their structure. therefore, we provide an r package called quacn providing a selection of new topological network descriptors. such descriptors are numerical graph invariants that quantitatively characterize the structure of the underlying network. note, that the authors use the words descriptor, measure, or index as synonym for topological network descriptors. quantifying the complexity of networks appears in different scientific disciplines and has been a challenging research topic during the last decades. importantly, little is known about the structural interpretation of topological network descriptors. this relates to information-theoretic measures that had been used to determine the entropy of the graph topology. other topological network descriptors had been used also in mathematical and medical chemistry including drug design to analyze and characterize the structure of chemical compounds. in more biologically motivated work, xia et al. used the vertex degree of protein-protein interaction networks to correlate the structural complexity of proteins and the organismal complexity with the complexity of the underlying ppi network. they show that the ppi domain coverage significantly correlates with the vertex degrees of the ppi networks. in another study, mazurie et al. used different network measures to link the structure and complexity of metabolic reactions to the phylogeny of species. their results show that a small set of descriptors reproduces the phylogenetic distances accurately. numerous network measures have been developed, but it would be out of the scope of this paper to explain them in detail. for further investigation see the recently and up to date review due to dehmer and mowshowitz. apart from information-theoretic measures, todeschini et al. provides a compelling overview of available network descriptors. but from, the feasibility and properties of a large number of descriptors remain untackled. quacn provides a selection of topological network descriptors. it offers the possibility to apply the indices in a standardized and intuitive manner. thus, it can support the scientific community to investigate these methods in different kinds of biological applications. a typical setup for a study to analyze biological networks structurally is illustrated in figure it shows a general workflow to analyze microarray studies using a network approach with topological network measures. of course, there also exist freely available tools, e.g., powermv or joelib to calculate network descriptors. however, these tools are designed for quantitative structure-activity relationship. thus, they do not support common exchange standards for biological data. compared to commercial software tools as dragon or preadmet, quacn is published under an open source license and freely available. therefore, it offers the possibility to adjust and further develop the existing indices or even add additional descriptors to the package. compared to the r-packages igraph and rbgl, which contain a few basic descriptors, quacn contains a selection of more sophisticated network descriptors. to our best knowledge, it is the only available software package that contains sophisticated measures such as the parametric graph entropies. we recommend quacn to investigate large-scale complex networks. further, we expect that the package will be helpful for exploring questions concerning the structure of biological networks in the context of systems biology. generally, quantitative network analysis is a non-trivial task, since it is necessary to understand the methods in detail to interpret the results correctly. this manuscript addresses readers who want to analyze networks structurally. its aim is to guide the reader to correctly apply the methods provided by quacn. this manuscript does not deal with the issue of inferring robust and valid networks. neither does it explain the network measures in detail nor how to interpret the results of the topological networks descriptors, as this would go beyond the scope of this paper. dehmer et al. dealt with these questions extensively. this paper is structured as follows: the section implementation gives an overview about the topological network descriptors, implemented in the r-package quacn. the section results and discussion illustrates how to apply the topological descriptors to concrete networks. also, we show the behavior of selected measures using small example graphs. moreover, we demonstrate their performance by applying them to biological networks. further, we illustrate possible use cases using topological network descriptors for performing a quantitative analysis of biological networks. the section summary and outlook concludes and summarizes the paper and outlines future developments. implementation we implemented a selection of topological network descriptors discussed in. table gives an overview about all implemented network measures with the name of the function to call the corresponding descriptors in r. for a detailed description of all implemented descriptors in quacn, see the package vignette or additional literature. this table gives an overview about the implemented topological network descriptor including the function name in quacn and the reference to the corresponding publication. the measures can be categorized within the following groups: descriptors based on distances in a graph this class contains measures that use distances between nodes to capture the structural complexity of the underlying network. a famous and classical representative of this group is the wiener index that has been defined by the sum of all distances within the network. we also integrated a group of basic distance-based descriptors introduced by skorobogatov and dobrynin. descriptors based on other graph invariants the descriptors in this class use other graph invariants than distances to characterize the structural complexity of complex biological networks. for example, the zagreb group indices are based on the degree of the vertices. the normalized edge complexity is calculated by using the adjacency matrix and the number of vertices. information measures for an extensive overview of measures of this class, see. • partition-based graph entropy descriptors these measures use an arbitrary graph invariant and an equivalence criteria to induce partitions. a probability value is calculated for each partition to determine the entropy, based on the entropy formula due to shannon. the topological information content introduced by rashevsky and reformulated by trucco is based on partitions of vertices that are in the same vertex orbit, to calculate the entropy of a graph. additionally, mowshowitz investigated mathematical properties of the index to characterize product graphs and other sophisticated measures such as the chromatic information content of a graph. • parametric graph entropy measures measures of this class assign a probability value to each vertex of a graph, using so-called information functionals which capture structural information of the network. a special information functional quantifies the structural information by using the cardinalities of the corresponding j-spheres. the derived probability distribution is used to calculate the entropy, which has been called dehmer entropy. as mentioned above, it is not the aim of this manuscript to describe all descriptors in detail. for a better understanding of the used descriptors see the vignette of quacn and the extensive work of dehmer and mowshowitz on information measures for networks. quacn is entirely written in r and detailed help is available according to the r documentation standards.  the examples below show the functionality of quacn by using a selection of small example graphs, which are shown by figure our goal is to show how the methods work and to apply the measures to a multitude of complex networks that may lead to novel applications in the field. example graphs to demonstrate the usefulness of topological network descriptors, we consider figure showing six undirected example graphs. an undirected graph or network g = consists of a non-empty vertex set v. e is called the edge set of g and is the set of unordered pairs of elements of v. we calculate exemplary a set of descriptors consisting of the wiener index w, the balaban-like index x, the topological information content iorb and the dehmer entropy ifv. the results are shown in table results of some selected descriptors applied to the small example graphs shown in figure calling the corresponding methods in r can be done in different ways. the following example shows how to calculate the wiener index from the graphnel-object g, representing the example graph in figure > wiener 56 as all descriptors are implemented as r-functions it is possible to easily calculate them for a set of graphs using the methods from the apply-family. > sapply note that each descriptor has at least two parameters as listed in table however, passing the distance matrix to the corresponding function is optional. if the parameter remains empty or is set to null the distance matrix will be calculated within each function. if calculating more than one descriptor for one graph, it is recommended to calculate the distance matrix separately and pass it to each method, instead of recalculating it again. particularly when using large networks it can save a lot of time to calculate the distance matrix only once. it will enhance the performance of the calculations significantly. we demonstrate the pre-calculation of the distance matrix in the next example, where we calculate four descriptors for the example graphs in figure the results of the below listed function call are listed in table this table shows the two parameters that are common for every method. > descriptors <- sapply{ +    dm <- distancematrix +    result = list() +    result] <- wiener +    result] <- balabanlike2 +    result] <- +       topologicalinfocontent$iorb +    result] <- +       infotheoreticgcm$entropy +    return + }) calling topological information content and the dehmer entropy returns a list of different variables. in the example we only use the entropy value of the descriptor. the call of the function works like all other methods, but it returns a list of different values. to explain the result of this function we apply it to graph in figure 2: > topologicalinfocontent $entropy $orbits 1 the implementation of the topological information content returns a list containing the entropy and the number of nodes within the same orbit. this information can be used for different other applications, e.g. to determine a graph prototype, see. the numerical results of the foregoing example can be seen in table the visual representation of the normalized results in figure shows the different behavior of the topological network descriptors using the example graphs. the example graphs start with a linear graph and the branching of the graphs increases towards. in this context, branching correlates with the number of terminal vertices. the wiener index is known as an index to detect molecular branching, and one can see that the wiener index represents increasing branching with decreasing values. furthermore we can see in this example, that the balaban-like index x also detects branching well. note, that its values are just given in a reverse order. the topological information content is based on partitions of vertices that are in the same vertex orbit. but calculating iorb shows that the quantity does not reflect branching properly. as known, iorb is a symmetry-based measure rather than an index for structural complexity. in this example, the dehmer entropy with monotonously decreasing weighting parameter ci and the information functional using the j-spheres, neither reflects branching appropriately. the information functional using the j-spheres itself has been used to investigate the information spread in a network. however, with a different parameter setting, the dehmer entropy reflects branching of certain networks meaningfully. however, this simple but demonstrative example indicates that not every topological information index is suitable for a particular problem. it is a challenging task to derive general statements about the structural complexity captured by such measures. it is even harder to connect biological properties with topological network descriptors. despite the fact that we often do not know the biological interpretation of topological network measures exactly, they can be helpful in a broad range of biological questions. for example, classifying biological data or identifying meaningful biological features, by analyzing the topology of biological networks. to conclude this section, we want to emphasize that one has to understand the selected descriptors and measures in detail to interpret the results correctly. note that topological network analysis is a non-trivial task and one has to know specific properties of the descriptors to solve a particular problem dealing with networks. one example is the group of balaban-like indices x and u. for a graph with two vertices connected with one edge the index is defined as infinite. that is also returned by the quacn-method but accompanied by a warning: > g = new > # add nodes > g = addnode > g = addnode > g = addedge > balabanlike1 inf warning message: in balabanlike1: graphs with |v| < result in: inf! it is important to know how the different descriptors are defined, when processing and interpreting the results. note, that not each combination of networks and descriptors could be tested and considered within the exception handling. keep in mind that applying quacn to concrete networks can result in special values, not available or not a number ). the next section shows an example of a possible application of quacn with biological networks. we will also use this chapters to explain the usage of more complex descriptors implemented in quacn. supervised machine learning for prostate cancer networks in this section, we present an application of topological network descriptors to classify gene networks inferred from gene expression data. note, we do not aim to justify network-based approaches itself and compare them to alternative approaches. in fact, a large body of literature dealing with networks does exist, i.e., see. this example was chosen to explain a possible application of topological network descriptors on biological data. therefore, we will focus on the methodical usage of the network measures and not on the biological interpretation of the results. to perform our analysis, we selected seven public available studies of prostate cancer from ncbi geo and ebi arrayexpress and inferred networks using the c3net inference method. this resulted in seven networks {gib}i= representing benign tissue and seven networks {gic}i= representing cancer tissue. then we extracted subgraphs from these networks based on the gene ontology database. for each network and each go-term we extracted one subgraph containing the genes associated with this specific go-term. this resulted in a total of networks representing benign tissue and networks representing cancer tissue. the numbers are different because the network structure of gib and gic is different and, hence, not all pathways are captured by these networks. whenever a subnetwork contained less than genes associated with a go-term, we excluded this pathway from the analysis. the obtained network sets can be seen as an approximation of two populations. one population represents benign and the second cancerous molecular interactions. additionally, we calculated all topological network descriptors available in quacn, as feature vectors for each of these networks. afterwards, we performed feature selection and classification using random forest with 10-fold cross-validation. in order to correct the selection bias, an external cross validation is applied to the selection process. in particular, we performed the selection process within each cv-loop. we trained the classifier to classify cancer networks versus benign networks, what lead to a mean classification performance of a f-score of and an accuracy of. this demonstrates that the topological network descriptors, integrated in quacn, are able to capture group specific structural features meaningfully to distinguish between networks representing prostate cancer and benign tissue. importantly, this result is not trivial as one could easily show by using other measures or only a particular fraction thereof, the classification task would result in a random classification. hence, this result would not be feasible in practice. as already mentioned we won't focus on a biological representation of the results, as it is the aim of this publication to discuss the methodical perspective of the presented r-package. one of the measures that showed a significant group effect was the dehmer entropy. the dehmer entropy is a complex measure with several parameters. it is possible to choose the information functional f, the weighting parameter ci and the scaling constant λ. the means of these parameters has been discussed in. the user can specify four different information functionals using j-spheres, path lengths, vertex centrality or degree-degree associations. we implemented different pre-settings for the weighting parameter ci: constant, linear, quadratic or exponential. a customized setting for ci can also be declared. the following example shows how to call the function to calculate a dehmer entropy. the information functional using j-spheres with an exponential setting for ci and a scaling constant λ = are used. > infotheoreticgcm $entropy $distance $pis 4 7 $fvis 4 7 this function returns a list containing a more comprehensive result than the other measures. certainly, the list contains the dehmer entropy denoted by $entropy. the list entry named $distance contains the distance of the entropy from maximum entropy. it also returns the results of calculating the information functional and the corresponding probability distribution. the probability distribution can later be used for further analysis, i.e. estimating the graph prototype of a set of networks.  the freely available open source r-package quacn contains a selection of topological network descriptors. the aim of this manuscript was to explain, how to apply the implemented descriptors correctly to complex biological networks using r. to provide a basic understanding of the application we demonstrated the behavior of the indices by applying them to small example networks. moreover, we presented an application for supervised machine learning from biological networks by using topological network descriptors. within these examples we demonstrated the correct usage of the methods included in quacn. machine learning is not the only application that topological network descriptors can be used for. they also can be utilized to compare networks. in this sense, kugler et. al. calculated the kullback-leibler divergence to perform an integrative network analysis. topological network descriptors have been standard methods in the field of quantitative structure property activity relationship. the methods implemented in quacn had already been used for qsar/qspr applications, see. further applications of information-theoretic measures had been discussed by dehmer and mowshowitz. the indices integrated in quacn can also be efficiently applied on large networks as their calculation requires polynomial time complexity. however, there also exist some indices whose algorithms are np-complete, but they have not been integrated in the package. importantly, not every index is suitable for any application in network biology and it strongly depends on the underlying research question which measures can be considered as appropriate. using the concept of advanced network descriptors is relatively new in systems biology. advanced network descriptors are able to quantify specific topological characteristics of the underlying network but the interpretation of the structural properties of the applied measures is still an ongoing task. however, modeling biological systems as networks had become an important task in recent systems biology research and created a need for methods to analyze them structurally. therefore, the topological network measures provided by quacn can stimulate the research in this field. however, a thorough analysis to investigate the behavior of topological information indices on biological networks is planed to be performed. as future work, we plan to apply the integrated measures on various biological research questions, and to extend the range of functions with new promising descriptors for coming versions of quacn. the next step is to integrate a group of already existing polynomial-based descriptors. finally, we are convinced that this package will turn out to be useful for a community dealing with network biology. availability and requirements project name: quacn - quantitative analysis of complex networks project home page: http://cran.r-project.org/web/packages/quacn/ operating system: platform independent programming language: r license: lgpl competing interests the authors declare that they have no competing interests. authors' contributions lajm and kgk implemented and tested the r-package, performed the analysis and interpreted the results. lajm, kgk, ag, fes and md and wrote the manuscript. md supervised the study. all authors read and approved the final manuscript. 
exemplarily, the classification of complex biological networks can be named, for which structural measures are used leading to a minimal classification error. moreover, we show a representative application to illustrate their capabilities for classifying biological networks. the package can be used to answer intriguing research questions in network biology, e.g., classifying biological data or identifying meaningful biological features, by analyzing the topology of biological networks. that means, it remains often unclear whether a particular measure is useful and feasible to solve a particular problem in network biology. hence, there is a strong need to provide freely available software packages to calculate and demonstrate the appropriate usage of structural graph measures in network biology. here, we discuss topological network descriptors that are implemented in the r-package quacn and demonstrate their behavior and characteristics by applying them to a set of example graphs. note that quacn is the first freely available software written in r containing a large number of structural graph measures. the r package quacn is under ongoing development and we add promising groups of topological network descriptors continuously.
 structural measures for networks have been extensively developed, but many of them have not yet demonstrated their sustainably. that means, it remains often unclear whether a particular measure is useful and feasible to solve a particular problem in network biology. exemplarily, the classification of complex biological networks can be named, for which structural measures are used leading to a minimal classification error. hence, there is a strong need to provide freely available software packages to calculate and demonstrate the appropriate usage of structural graph measures in network biology.  here, we discuss topological network descriptors that are implemented in the r-package quacn and demonstrate their behavior and characteristics by applying them to a set of example graphs. moreover, we show a representative application to illustrate their capabilities for classifying biological networks. in particular, we infer gene regulatory networks from microarray data and classify them by methods provided by quacn. note that quacn is the first freely available software written in r containing a large number of structural graph measures.  the r package quacn is under ongoing development and we add promising groups of topological network descriptors continuously. the package can be used to answer intriguing research questions in network biology, e.g., classifying biological data or identifying meaningful biological features, by analyzing the topology of biological networks. 