Skip to content

PathwaySpace is an R package that creates landscape images from graphs containing vertices (nodes), edges (lines), and a signal associated with the vertices.

Notifications You must be signed in to change notification settings

sysbiolab/PathwaySpace

Repository files navigation

PathwaySpace: Spatial projection of network signals along geodesic paths

PathwaySpace is an R package that creates landscape images from graphs containing vertices (nodes), edges (lines), and a signal associated with the vertices. The package processes the signal using a convolution algorithm that considers the graph's topology to project the signal on a 2D space. Figure 1 illustrates the convolution operation problem addressed by the PathwaySpace package. For detailed documentation and usage examples, see the package's vignettes and workflows.

PathwaySpace could have various applications, such as visualizing network data in a graphical format that highlights the relationships and signal strengths between vertices.

Alt text

Figure 1. Signal processing addressed by the PathwaySpace package. A) Graph overlaid on a 2D coordinate system. Each projection cone represents the signal associated with a graph vertex (referred to as vertex-signal positions), while question marks indicate positions with no signal information (referred to as null-signal positions). Inset: Graph layout of a toy example used in the package's vignette. B) Illustration of signal projection from two neighboring vertices, simplified to one dimension. Right: Signal profiles from aggregation and decay functions.

Installation in R (>=4.4)

Install dependencies to build the package's vignettes
install.packages("knitr")
install.packages("rmarkdown")
Install the PathwaySpace package
install.packages("remotes")
remotes::install_github("sysbiolab/RGraphSpace", build_vignettes=TRUE)
remotes::install_github("sysbiolab/PathwaySpace", build_vignettes=TRUE)

Examples

Follow the PathwaySpace vignette and try to make some brain plots!

library(PathwaySpace)
vignette("PathwaySpace")

Citation

If you use PathwaySpace, please cite:

Supporting Material for Tercan et al. (2025)

Download and uncompress Tercan_et_al_20250112.zip, then follow the instructions in the pspace_perturbation.R script. This R script has been developed to reproduce the results presented in Figure S1 of Tercan et al. (2025).

Licenses

The PathwaySpace package is distributed under Artistic-2.0

About

PathwaySpace is an R package that creates landscape images from graphs containing vertices (nodes), edges (lines), and a signal associated with the vertices.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Contributors 2

  •  
  •