cc-webgraph

Tools to construct web graphs from Common Crawl data, process and explore them.

Compiling and Packaging Java Tools

Java 11 or upwards are required.

The Java tools are compiled and packaged by Maven. If Maven is installed just run mvn package. Now the Java tools can be run via java -cp target/cc-webgraph-0.1-SNAPSHOT-jar-with-dependencies.jar <classname> <args>...

The assembly jar file includes also the WebGraph and LAW packages required to process the webgraphs and compute PageRank or Harmonic Centrality.

Javadocs

The Javadocs are created by mvn javadoc:javadoc. Then open the file target/site/apidocs/index.html in a browser.

Memory and Disk Requirements

Note that the webgraphs are usually multiple Gigabytes in size and require for processing - a sufficient Java heap size (Java option -Xmx) - enough disk space to store the graphs and temporary data.

The exact requirements depend on the graph size and the task – graph exploration or ranking, etc.

Construction and Ranking of Host- and Domain-Level Web Graphs

Host-Level Web Graph

The host-level web graph is built with help of PySpark, the corresponding code is found in the project cc-pyspark. Instructions are found in the script build_hostgraph.sh.

Domain-Level Web Graph

The domain-level web graph is distilled from the host-level graph by mapping host names to domain names. The ID mapping is kept in memory as an int array or FastUtil's big array if the host-level graph has more vertices than a Java array can hold (around 2³¹). The Java tool to fold the host graph is best run from the script host2domaingraph.sh.

Processing Graphs using the WebGraph Framework

To analyze the graph structure and calculate rankings you may further process the graphs using software from the Laboratory for Web Algorithmics (LAW) at the University of Milano, namely the WebGraph framework and the LAW library.

A couple of scripts may help you to run the WebGraph tools to build and process the graphs are provided in src/script/webgraph_ranking/. They're also used to prepare the Common Crawl web graph releases.

To process a webgraph and rank the nodes, you should first adapt the configuration to your graph and hardware setup: vi ./src/script/webgraph_ranking/webgraph_config.sh After running ./src/script/webgraph_ranking/process_webgraph.sh graph_name vertices.txt.gz edges.txt.gz output_dir the output_dir/ should contain all generated files, eg. graph_name.graph and graph_name-ranks.txt.gz.

The shell script is easily adapted to your needs. Please refer to the LAW dataset tutorial, the API docs of LAW and webgraph for further information.

Exploring Webgraph Data Sets

The Common Crawl webgraph data sets are announced on the Common Crawl web site.

For instructions how to explore the webgraphs using the JShell please see the tutorial Interactive Graph Exploration. For an older approach using Jython and pyWebGraph, see the cc-notebooks project.

Credits

Thanks to the authors of the WebGraph framework used to process the graphs and compute page rank and harmonic centrality. See also Sebastiano Vigna's projects webgraph and webgraph-big.