igraph / igraph.org

igraph.org web site

The igraph library

igraph is a C library for complex network analysis and graph theory, with emphasis on efficiency, portability and ease of use.

See https://igraph.org for installation instructions and documentation.

igraph can also be used from:

• R — https://github.com/igraph/rigraph
• Python — https://github.com/igraph/python-igraph
• Mathematica — https://github.com/szhorvat/IGraphM

igraph is a collaborative work of many people from all around the world — see the list of contributors here. If you would like to contribute yourself, click here to see how you can help.

Citation

If you use igraph in your research, please cite

Csardi, G., & Nepusz, T. (2006). The igraph software package for complex network research. InterJournal, Complex Systems, 1695.

igraph.org's Issues

Py docs: missing icons and bad header styling

The screenshot is from the Python tutorial. Notice missing icon and bad header formatting (rounded corner, gap above).

Broken link in tutorial/0.9.8

Thank you for your great works!

I found a broken link while learning from tutorial.

description section of layout_drl has a broken link (https://www.cs.sandia.gov/~smartin/software.html).

tutorial page : https://igraph.org/python/tutorial/0.9.8/tutorial.html#layout-algorithms

Add formulas to the documentation

Hi Team,

You are doing a great job with the igraph library. I am doing some analysis using python-igraph and getting issue understanding the functions in their mathematical terms. As we need to base our analysis on mathematical terms for research papers, please include the formulas of the functions in their documentation. Inclusion of formula has been beautifully done by Networkx, for example, please check one of their documentation page

Thanks.

Broken links in r-igraph docs

Dear all, I think there is a problem with the links in r-igraph docs. More precisely, when I check the online version of the R manual, then everything works fine. On the other hand, the links included on any specific page (i.e. the igraph package page) or "See also" section(s) (e.g. add.edge function) point to an empty page with a 404 -file not found error message (e.g. here).

I'm not sure, but I think that the URL(s) were defined using the wrong pattern (i.e. igraph/help/something.html instead of r/doc/something.html).

Can not access http://nexus.igraph.org repository

Favicon doesn't look good on dark background

A very minor thing:

The favicon doesn't look great on a dark background. Here's Chrome on macOS in dark mode:

The black edges are not visible on a dark background.

Broken links

Broken links

• On https://igraph.sixdegrees.hu/r/

  • the link to igraphdemo
  • both links to binary packages under Downloads
  • all three package links under Optional Requirements (tcltk, rgl, ape). @gaborcsardi: please check, tcltk package isn't on CRAN anymore so I'm not sure where to link

• https://igraph.sixdegrees.hu/c/

  • Links under "Downloads - Current release – version" master are broken

(issue still work in progress)

Dead link

Hi,
in the following web page, in the "Tutorial" section, the link to "graph.structure", which points here, is dead

miss python-igraph introduction

https://igraph.org/python/tutorial/latest/intro.html#what-is-igraph

I think the introduction is a very important part, but it seems to be empty.

I'd like to contribute to this project, would you mind if I could fill it out?

Add warning to old versions of docs

A lot of google hits still go to the old versions of Python and R doc pages, e.g.:

https://igraph.org/r/doc/layout_with_lgl.html

https://igraph.org/python/api/0.9.11/igraph.Graph.html

If feasible and easy, it'd be useful to indicate that these docs are outdated with a banner like the one currently used in the new Python docs:

R docs: Argument names wrapped too tightly after restyling

After the docs were restyling, argument names for the R docs are wrapped too tightly. Screenshot:

Website icon missing

/img/igraph4.png, which is set as the website icon, is missing. SVG cannot be used as the icon, so igraph4.svg is not a direct replacement.

According to this, the way the shortcut icon is set is not correct.

igraph.org/_layouts/default.html

Line 9 in 450255d

<link rel="shortcut icon" href="/img/igraph4.png" type="image/x-icon" />

Header is too full for mobile

A very minor issue, but after adding two more links, the header now doesn't fit on mobile screens.

Not a big deal because I don't think there are good reasons to keep reading the website on mobile ...

Flow network

Move web page to igraph.org

From @gaborcsardi on November 6, 2013 15:31

In progress.

TODO list. These are needed for the move:

• Get started with Python
• Python docs
• R PDF manual
• C PDF manual
• C info docs
• check for broken links
• Downloads
• Warning banner on old docs pages at sourceforge
• Add version number to downloads section, and maybe docs section as well
• nightly sanitize input
• Update first section(s) of C manual, installation, etc. Make sure it is up to date.
• Check for links to sourceforge everywhere. E.g. in the R package, in the docs, etc. These need to be updated.
• Add google analytics.

These are optional:

• Make search work.
• Make sure PPA works, add links to PPA.
• C HTML bundle
• Affix does not work on NEWS page
• Create NEWS file(s) automatically from Jekyll posts
• Icons instead of [R] [C] and [PY]
• Wiki
• Wiki gallery
• Screenshots and examples
• RSS feed for news
• Add links to old docs
• Add version number to navbar (?)
• nightly sorting
• nightly remove old files
• nicer pygments

Copied from original issue: igraph/igraph#535

Need vertical spacing around links to interfaces

In a narrow window, or mobile, the page looks like this:

Adding some vertical spacing around these buttons, e.g. adding margin: 0.1em 0 to the btn class, would make it look a bit better:

404 page in the Google results!

404 page:
https://igraph.org/python/api/0.10.0/igraph.automorphisms.html

Google result page "igraph automorphism python":
https://www.google.com/search?sxsrf=ALiCzsYFOc5uIyHDbM8kSgMMGzB52S4_7Q:1666433818114&q=igraph+automorphism+python&sa=X&ved=2ahUKEwi7pZTezfP6AhXdhP0HHaONDm8Q7xYoAHoECAYQAQ

Put blog/news into another repo

So that we can update it easily, without needing the docs, etc.

Make it possible to generate the API docs for only newer versions

Simply adding a new version for which we want to generate API documentation in the Makefile has no effect; running make will not generate the API documentation if it has been generated earlier for a smaller set of versions because all the "stamp" files are unversioned. E.g., after adding a new Python version, I cannot simply run make python to update the Python docs. Running make clean_python && make python does the trick; however, it removes the entire Python build folder and all the generated Python docs so everything will be re-built from scratch. This will become a bottleneck as soon as we start having more versions in the makefile.

The ideal solution would be for make python to recognize that a new version was added and to build the documentation for that version only, leaving all previously generated versions alone.

404 https://igraph.org/python/doc/tutorial/tutorial.html#layouts-and-plotting

a broken link inside https://igraph.org/python/tutorial/0.9.6/visualisation.html page.

Add pointer to outside resources?

Hi!

Recently, I've been finding myself using outside tools that interface with iGraph, like Vincent Traag's community detection package ( https://github.com/vtraag/louvain-igraph ) and more recent InfoMap implementations (http://mapequation.org/code.html#Examples-as-cpp-library).

How would you feel about me adding a small page to make users aware of these add-ons? And if so, where would be the best place to make such a contribution?

Thanks!

C/igraph docs: Many of the links don't work due to upper/lowercase issue

Currently, many of the links in the C/igraph docs on the website do not work, apparently due to a case sensitivity issue. Take a look here and try some links:

https://igraph.org/c/doc/igraph-introduction.html

E.g., this link does not work:

https://igraph.org/c/doc/igraph-Introduction.html#idm209455317712

because of the capital I in Introduction. Changing that to lowercase fixes it. This works:

https://igraph.org/c/doc/igraph-introduction.html#idm209455317712

please explain vertex and edgein beginners intro

Hi,
been trying to wrap my head around this intro page on igraph and python here

https://igraph.org/python/doc/tutorial/tutorial.htm

However I do not know what the explainer means with "vertex" and "edge".
A small text with accompanying graph for explanation would have helped me. Without these two concepts explained the rest of the intro is hard to follow.

The best explanation I found is on wikipedia:
https://en.m.wikipedia.org/wiki/Vertex_(graph_theory)

a vertex is a node. So speaking of vertex (node) clears it all up.

Just a tip from the formerly ignorant

thanks

order of the buttons on the homepage

Below

I'd expect the C library to come first on the left.

Fix building for new repo structure

igraph/igraph
igraph/rigraph
igraph/python-igraph

Version switcher in header should be loaded with JS

Right now the version switcher in the header of all documentation pages is embedded in the HTML file. This means that whenever a new Python version is added, Jekyll needs to update the documentation pages of all previous Python versions in order to update the version switcher in the header.

Maybe we should generate the version switcher in the header using some JS code instead? This way we would have a JS file that all HTML pages needing a version switcher would include, and we would only need to update the JS file whenever a new version is added.

Spurious spaces in container docs

Somehow we are ending up with spurious spaces in the container docs (e.g. vector_ copy instead of vector_copy).

Create Twitter handle

I'm doing a talk where I mention IGraph. My VP of marketing is very good at getting the word out on social media. Please create a Twitter or FB page for us to reference!

Add a common NEWS section to the main page

For general announcements.

Python docs have wrong links to api

The main page of the Python docs has outdated links given the current organization of the docs: it links to /python/doc/igraph.Graph-class.html and /python/doc/igraph.GraphBase-class.html while the correct path uses python/doc/api/ and does not include -class (example for GraphBase).

Either the docs structure should be reverted (remove api/ and readd -class) or these links should be updated.

EDIT: note that if the latter option is used, you're breaking pretty much all existing links to igraph functions from other websites since these would use the Graph or GraphBase pages.

404 https://igraph.org/c/versions/latest/

https://igraph.org/c/doc/igraph-Separators.html

latest item linked to a broken and 404 page!