Giter Club home page Giter Club logo

muxviz's Introduction

muxViz v3.1: The R package

Lifecycle: experimental

Installation

v3.1 is the latest and is continuously updated. It is an R package (still in development, not on CRAN) which can be installed in R by

devtools::install_github("manlius/muxViz")

Background

The R package muxViz enables the visualization and the analysis of interconnected multilayer networks. It supports the analysis of multilayer data:

  • Multilayer correlation analysis
  • Multilayer centrality analysis and annular representation
  • Multilayer community structure detection
  • Multilayer structural reducibility
  • Multilayer motifs analysis
  • Animated visualization of dynamical processes and time-varying multilayer networks

muxViz supports the analysis and visualization of the following multilayer networks: Multilayer networks supported in muxViz

and the following layer layouts: Multilayer layouts supported in muxViz

What is a multilayer network?

Multilayer networks are a class of models widely adopted to represent empirical complex system, including biomolecular networks (eg, interactomes, metabolomes), neuronal networks (eg, connectomes), information and communication networks, social/socio-technical/socio-ecological networks, economic and financial networks, urban and transportation networks.

You can read more on the dedicated Wikipedia page or this short illustrated summary.

Documentation

Check the full package documentation (with usage tips and examples) at docs, where you can also find a couple of vignettes on multilayer community detection , on multilayer network motifs and on how to setup the Infomap and fanmod routines.

Check out also these examples.

News

Check the release news.

Citation

If you use muxViz (or any part of muxViz, or images available in the gallery) for your multilayer analysis and visualization, you should cite the paper

Manlio De Domenico, Mason A. Porter, Alex Arenas, Multilayer Analysis and Visualization of Networks, published in Journal of Complex Networks 3, 159-176 (2015) (Open Access)

Manlio De Domenico, Multilayer Networks: Analysis and Visualization. Introduction to muxViz with R. To be published by Springer-Verlag (2021)

Please, note that muxViz is based on some algorithms developed in other studies. You should cite the original paper(s) every time that you use those algorithms.

Official Websites and Social Networks

QUESTION/BUGS/COMMUNITY: muxViz can count on a community with more than 600 members. Visit the dedicated Google Group. Requests via Github will be considered more slowly.

You might also want to take a look at muxViz in action: see the Youtube channel.

Instead, if you create amazing visualizations using muxViz and you want to tweet them, remember to include the “#muxviz” hashtag: we will be happy to retweet.

You might be interested in taking a look at the official blog about muxViz, with posts about applications (analysis, visualization or both) to cool datasets (updated not too frequently).

The Graphical User Interface

The previous implementation exploits a Graphical User Interface (working with any browser) to provide access to many customizable graphic options to render networks.

muxViz GUI

muxViz data

More details on the GUI (requirements, installation and usage) can be found in the GUI README.

Copyright

(C) Copyright 2013-2021, Manlio De Domenico.

This code has no warranty whatsoever and any kind of support is provided. You are free to do what you like with this code as long as you leave this copyright in place. Please, explicitly cite muxViz if you find it useful for your visualizations.

  1. Copyright 2013-2021, Manlio De Domenico (manlio.dedomenico at urv.cat)

Each file in this folder is part of the muxViz package, if not specified otherwise by another license.

muxViz is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

muxViz is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with the package. If not, see http://www.gnu.org/licenses/.

Credits

This work has been partially supported by European Commission FET-Proactive project PLEXMATH (Grant No. 317614) (http://www.plexmath.eu/), the European project devoted to the investigation of multi-level complex systems and has been developed at the Alephsys Lab (http://deim.urv.cat/~alephsys/),

I am in debt with Alex Arenas for proposing this project, with Mason A. Porter and the members of the Alephsys Lab for invaluable suggestions and feedbacks.

I would like to thank Inderjit S. Jutla, Lucas G. S. Jeub, and Peter J. Mucha for making their code about multislice community detection available.

I would like to thank Martin Rosvall for allowing to distribute his C++ code for Multiplex Infomap under the AGPLv3 license.

I would also like to thank the following people for their unvaluable (voluntary) support to muxViz and parts of its development:

  • Lucio Agostinho Rocha
  • Francesc Font
  • Patricia Gonçalves
  • Kim Klark
  • Sneha Rajen
  • Maria Pereda
  • Hiroki Sayama
  • Tzu-Chi Yen
  • Rafael Pereira
  • Yuriko Yamamoto
  • Rodrigo García
  • Sergio Alcalá-Corona
  • Guillermo de Anda Jáuregui
  • Giulia Bertagnolli

The development of muxViz has been funded, or is currently funded, by the following entities and institutions:

muxViz funding

Donation

muxViz is a free and open-source platform that has been used for scientific purposes in a variety of disciplines, including computational social science, computational neuroscience, computational biology, computational psycholinguistics, multi-modal transportation engineering and physics.

Since January 2016, muxViz is periodically updated and maintained for free by its developer and its enthusiastic community of users (the muxVizers).

If muxViz helps you with your research and reduces your time to develop, you can give us a cup of good coffee :)

BTC: 19RGUCZjSzvbjY5xEWz3GNg7MnMiPyEgbB

ETH: 0xe5027b44782a4b832a23773ffdb57658aff62e31

XMR: 49pQ1B2m2UHaKotqF8h1E89um9rnMPvAHEfGUET1icQUaxBV1KFhuTNVpsF6Kf4bf5dZwWvmdzYn4D7rKcL4v2ee3tH4E2L

Paypal:

paypal

muxviz's People

Contributors

gbertagnolli avatar kevinheffernan avatar manlius avatar pitmonticone avatar wuhaochen avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

muxviz's Issues

Error for plot_multiplex3D

I followed the tutorial for "Multilayer community detection" (.../Documents/GitHub/muxViz/docs/articles/ml_community.html) but got an error when running

# Show the multiplex network
plot_multiplex3D(g.list, layer.layout=lay, layer.colors=layer.colors,
                         layer.shift.x=0.5, layer.space=2,
                         layer.labels="auto", layer.labels.cex=1.5,
                         node.size.values="auto", node.size.scale=0.8,
                         show.aggregate=T)

Here is the error message:
Error in !is.na(layer.labels) && !is.null(layer.labels) :
'length = 3' in coercion to 'logical(1)'

> !is.na(layer.labels)
[1] TRUE TRUE TRUE
> !is.null(layer.labels)
[1] TRUE

The first line returns 3 TRUE while the second only 1, so when using &&, an error is returned. This seems to be an inherent error in the source code. I suspect this issue should be resolved internally. Please let me know if I am wrong.

fatal error of Rstudio when loading the package

I can install the package by using teh devtools without problem, however every time when I load the pkg, Rstudio with crash with fatal error
image

The session info are as follows:
R version 4.2.0 (2022-04-22 ucrt)
Platform: x86_64-w64-mingw32/x64 (64-bit)
Running under: Windows 10 x64 (build 19044)

Matrix products: default

locale:
[1] LC_COLLATE=Chinese (Simplified)_China.utf8
[2] LC_CTYPE=Chinese (Simplified)_China.utf8
[3] LC_MONETARY=Chinese (Simplified)_China.utf8
[4] LC_NUMERIC=C
[5] LC_TIME=Chinese (Simplified)_China.utf8

attached base packages:
[1] stats graphics grDevices utils datasets methods
[7] base

loaded via a namespace (and not attached):
[1] compiler_4.2.0 tools_4.2.0

Where are the Demo / Example code??

“To speed up your interaction with muxViz, the folder standalone contains some self-explanatory example scripts which show how to use the most salient analytical techniques available in the library:
community_detection.R
connected_components.R
example_coverage_optimized.R
example_coverage.R
example_overlapping_generator.R
example_plot_edgecolored_heatmap_6panels.R
example_plot_edgecolored_paths_coupling.R
example_plot_edgecolored_paths.R
example_plot_edgecolored.R
example_transitivity_new.R
layer-layer_corr.R
multi_motifs.R”

Where are they???

Can't Install the package

Hi
I am getting an error while installing the package.

Installing package into ‘C:/Users/svishwakarma/Documents/R/win-library/3.5’
(as ‘lib’ is unspecified)
Warning in install.packages :
cannot open compressed file 'muxViz-master/DESCRIPTION', probable reason 'No such file or directory'
Error in install.packages : cannot open the connection

Please let me know what to do in this issue.

Can't Install the package.

I am getting this warning.
Warning in install.packages :
cannot open compressed file 'muxViz-master/DESCRIPTION', probable reason 'No such file or directory'
Error in install.packages : cannot open the connection

could not find function

muxViz/examples-scripts/example_coverage_optimized.R

Line 104:

cov.mul.appr <- GetCoverageEvolutionEdgeColored(T.mux, Layers, Nodes, TAUS, Approximate=T, Approximate.disconnected=DisconnectedNodes)

Error in GetCoverageEvolutionEdgeColored(T.mux, Layers, Nodes, TAUS, Approximate = T, :
could not find function "GetCoverageEvolutionEdgeColored"

Some similar "could not find function" problem happened in example_coverage.R and example_overlapping_generator.R

session error

i can open 127.0.0.1, but can't import files.

Error : package or namespace load failed for ‘OpenStreetMap’:
loadNamespace()里算'rJava'时.onLoad失败了,详细内容:
调用: fun(libname, pkgname)
错误: JAVA_HOME cannot be determined from the Registry
此外: Warning messages:
1: In library(package, lib.loc = lib.loc, character.only = TRUE, logical.return = TRUE, :
不存在叫‘session’这个名字的程辑包

Import of external data based on excel

I have successfully installed muxViz and used the example data for analysis and visualisation. But what should I do with the data if I want to analyse it based on my own data? I hope I can get your help on this! Thanks!

Bug in loading external color sheet

This works well if I import the txt file before I load any other data. However, if I load the graphics after I've loaded the edges. layers and nodes, I get the following error message:

Warning: Error in $<-.data.frame: replacement has 0 rows, data has 1255
  91: stop
  90: $<-.data.frame
  76: observeEventHandler [C:\Users\username\Documents\muxviz\muxViz-master/server.R#8434]
   5: runApp

Is the project dead?

Hi,
is this project unmaintained?
The last commit is dated January 2018, and there are some open issues as well.
Best

About shinyjs

When I trying to install your muxViz, there is a error:colourInput() has been moved to the 'colourpicker' package.
I asked others he tell me the colourinput() funcition now is in the colourpicker instead of shinyjs.
I want to konw if I want to modify profile, where should I modify.

I have a problem with the "ShinyDash" installations

R Studio send me this message, please, helpme

Loading required package: RSpectra
Error in library(ShinyDash) : there is no package called ‘ShinyDash’
Además: Warning message:
Error in library(ShinyDash) : there is no package called ‘ShinyDash’ > install.packages("shiny")
WARNING: Rtools is required to build R packages but is not currently installed. Please download and install the appropriate version of Rtools before proceeding:

https://cran.rstudio.com/bin/windows/Rtools/
Warning in install.packages :
package ‘shiny’ is in use and will not be installed

example_transitivity_new.R bugreport

muxViz/examples-scripts/example_transitivity_new.R

line 27
binarizeMatrix()
Is it in library("Binarize") or library("BiTrinA") ?

And line 42
n.tri["mux"] <- GetGlobalNumberTriangles(M, Layers,Nodes)

Error in diag(A) : long vectors not supported yet: array.c:2186

Why error in importing external edge color and size under Visualization->Edges->Size and color->External?

Hi everyone! I've been working on this issue for two days but don't know how to fix it.
Here is my "external edge color and size" file (in txt format separated by space), sure for test, this file contains only 1 row besides the header :

1
The error says:
2
In English, it reads, "Error in $<-.data.frame: replacement has 0 row, data has 1".

I googled the error message almost everywhere on stackoverflow and many other websites but still don't know how to fix it.

I've also tried my best to retrieve the record but I don't know where the numbers before the information is, i.e., "91: stop","90:$<-.data.frame", etc, because they are not in muxVizGUI.R, not in server.R, not in ui.R, etc, thus, I cannot fix the problem according to the warning message.

At one time I thought it may be the wrong sequence to import the data before rendering the graph, I've tried:

  1. Apply layout-> import my external edges files ->Render network;
  2. import my external edges files ->Apply layout->Render network;

But neither of them works since the upload procedure is OK, but always fail in "import" procedure, as prompted by the lower right pop-up info messages.

Does anyone know how to fix the problem? I appreciate any of your help and thanks a lot!

Docker image can't access local paths.

I'm running muxViz through the Docker image. I can import my config file but the paths it lists aren't found by muxViz. I've tried placing all files within the same folder and prefacing filenames with "./" to no avail. Presumably this has something to do with the VM sandbox. How do I get the muxViz Docker to discover my local paths?

I tried switching to R directly but there's an rjava issue with OpenStreetMaps that I can't seem to overcome.

Results are not shown

Hi Dear Manlio and other experts,
Unfortunately the results of MuxViz are not shown!
It is important especially for Motifs.
I have tried different R and shiny versions on different Windows.
I would be pleased if you could help me.
2
1

Programmatic API

Can you please point me to the documentation for the programmatic interface?

EXPORTING IMAGES

Hello, I'm running muxViz on a Windows 10 64 bit OS, R version 3.4.3, RStudio version 1.1.423

I've managed to install and run analysis on a dataset and muxViz successfully displayed my rendered multilayer network on the RGL window. However, when I try to export the image (as a png file), I get the following error:

Warning in rgl.snapshot(FILE_RGL_SNAPSHOT) :
RGL: Pixmap save: unable to open file 'C:\Users\SANDRA\Documents\R\muxViz-master"C:\Users\SANDRA\Documents\R\muxViz-master\export\muxViz_05-03-2018_162649_05-03-2018_163223.png"' for writing
Warning in rgl.snapshot(FILE_RGL_SNAPSHOT) : 'rgl.snapshot' failed

When the program is actually trying to export the image, I see that the directory address displayed has both back- and forward slashes, however they do not appear in the resulting Warning message. I also get similar error when I'm trying to generate annular visualizations.

Any suggestions will be appreciated.

ERROR: File does not exist

I have created the files for a directed multilayer network (Extended_edges_list.txt, Info_Layer.txt, nodes_layout.txt, Config_file.txt) and try to load them into muxViz.
I browse the config file, I choose the Config_file.txt and click Import Network.

Samples of files are shown below:

Sample of Extended_edges_list.txt:

0 1 30 1
.
.
121 2 142 2
.
.
6 1 6 2
.
.
4763 7 4763 6

Info_Layer.txt:

layerID 
1 
2 
3 
4 
5 
6 
7 

sample of nodes_layout.txt:

nodeID 
1
2
.
.
4768

Config_file.txt:
<path goes here>/Extended_edges_list.txt;<path goes here>/Info_Layer.txt;<path goes here>/nodes_layout.txt

The files appear in the Configuration file Table under their corresponding categories but I get the following message in the bottom right of the screen.

ERROR: File does not exist <path goes here>/Info_Layer.txt

I am not sure what is going on or how to address this issue and any help would be most welcome!

MuxViz GUI and rgdal package

Hi MuxViz team!

I am trying to install the MuxViz GUI, and I am struggling because 'rgdal' and 'session' packages no longer supported as of 3 months ago. I wanted to alert you to this issue and ask if you had solutions.
I am attempting to run the following code:
https://github.com/manlius/muxViz/blob/master/gui-old/muxVizGUI.R

R version 4.3.1
R Studio Version 2023.09.1+494

Pasted is my error output:

Error in install.packages : Updating loaded packages
Loading required package: session
Warning in install.packages :
package ‘session’ is not available for this version of R

A version of this package for your version of R might be available elsewhere,
see the ideas at
https://cran.r-project.org/doc/manuals/r-patched/R-admin.html#Installing-packages
Loading required package: rgdal
Warning in install.packages :
package ‘rgdal’ is not available for this version of R

A version of this package for your version of R might be available elsewhere,
see the ideas at
https://cran.r-project.org/doc/manuals/r-patched/R-admin.html#Installing-packages
Error in library(ShinyDash) : there is no package called ‘ShinyDash’
In addition: Warning messages:
1: In library(package, lib.loc = lib.loc, character.only = TRUE, logical.return = TRUE, :
there is no package called ‘session’
2: In library(package, lib.loc = lib.loc, character.only = TRUE, logical.return = TRUE, :
there is no package called ‘rgdal’

Restarting R session...

install.packages("shiny")
trying URL 'https://cran.rstudio.com/bin/macosx/big-sur-x86_64/contrib/4.3/shiny_1.7.5.1.tgz'
Content type 'application/x-gzip' length 4354031 bytes (4.2 MB)
==================================================
downloaded 4.2 MB

The downloaded binary packages are in
/var/folders/k1/tmhjps3x3v182t2gz3tm8nmw0000gn/T//Rtmp3GQ9BV/downloaded_packages
Loading required package: lmerTest
Loading required package: lme4
Loading required package: Matrix

Attaching package: ‘lmerTest’

The following object is masked from ‘package:lme4’:

lmer

The following object is masked from ‘package:stats’:

step

Pasted is my output of my session info:

R version 4.3.1 (2023-06-16)
Platform: x86_64-apple-darwin20 (64-bit)
Running under: macOS Sonoma 14.0

Matrix products: default
BLAS: /System/Library/Frameworks/Accelerate.framework/Versions/A/Frameworks/vecLib.framework/Versions/A/libBLAS.dylib
LAPACK: /Library/Frameworks/R.framework/Versions/4.3-x86_64/Resources/lib/libRlapack.dylib; LAPACK version 3.11.0

locale:
[1] en_US.UTF-8/en_US.UTF-8/en_US.UTF-8/C/en_US.UTF-8/en_US.UTF-8

time zone: America/Los_Angeles
tzcode source: internal

attached base packages:
[1] stats graphics grDevices utils datasets methods base

other attached packages:
[1] lmerTest_3.1-3 lme4_1.1-34 Matrix_1.6-1

loaded via a namespace (and not attached):
[1] utf8_1.2.4 generics_0.1.3 stringi_1.7.12 lattice_0.21-8 digest_0.6.33 magrittr_2.0.3
[7] grid_4.3.1 pkgload_1.3.2.1 fastmap_1.1.1 processx_3.8.2 sessioninfo_1.2.2 pkgbuild_1.4.2
[13] urlchecker_1.0.1 ps_1.7.5 promises_1.2.1 purrr_1.0.2 fansi_1.0.5 scales_1.2.1
[19] numDeriv_2016.8-1.1 cli_3.6.1 shiny_1.7.5.1 crayon_1.5.2 rlang_1.1.1 ellipsis_0.3.2
[25] munsell_0.5.0 splines_4.3.1 remotes_2.4.2.1 cachem_1.0.8 devtools_2.4.5 tools_4.3.1
[31] memoise_2.0.1 nloptr_2.0.3 minqa_1.2.5 dplyr_1.1.3 colorspace_2.1-0 ggplot2_3.4.4
[37] httpuv_1.6.12 boot_1.3-28.1 vctrs_0.6.4 R6_2.5.1 mime_0.12 lifecycle_1.0.3
[43] stringr_1.5.0 htmlwidgets_1.6.2 fs_1.6.3 usethis_2.2.2 MASS_7.3-60 miniUI_0.1.1.1
[49] pkgconfig_2.0.3 callr_3.7.3 pillar_1.9.0 later_1.3.1 gtable_0.3.4 profvis_0.3.8
[55] glue_1.6.2 Rcpp_1.0.11 tibble_3.2.1 tidyselect_1.2.0 rstudioapi_0.15.0 xtable_1.8-4
[61] htmltools_0.5.6.1 nlme_3.1-162 compiler_4.3.1 prettyunits_1.1.1

Muxviz don't show my node labels

Hi,
I'm new in muxviz, and I want to show my node labels in my multilayer network, the problem when I check the case "Show nodes labels:" in the platform, it shows me only node ids.

My data in my Layout file is like that:
LAYOUT.txt

if can anyone help me in that I would be very thankful.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.