Open Source Ecosystems

Overview

Installation

PyPI

Check Python Packaging User Guide
pip install pyrgg==1.5

Source Code

Download Version 1.5 or Latest Source
pip install .

Conda

Check Conda Managing Package
conda install -c sepandhaghighi pyrgg

Exe Version (Only Windows)

Download Exe-Version 1.5
Run PYRGG-1.5.exe

System Requirements

Pyrgg will likely run on a modern dual core PC. Typical configuration is:

Dual Core CPU (2.0 Ghz+)
4GB of RAM

Note that it may run on lower end equipment though good performance is not guaranteed.

Usage

Open CMD (Windows) or Terminal (Linux)
Run pyrgg or python -m pyrgg (or run PYRGG.exe)
Enter data

Engines

PyRGG

Erdős–Rényi-Gilbert

Supported Formats

DIMACS

	p sp <number of vertices> <number of edges>
	a <head_1> <tail_1> <weight_1>

	.
	.
	.
		
	a <head_n> <tail_n> <weight_n>

Document
Sample 1 (100 Vertices , 3KB)
Sample 2 (1000 Vertices , 13KB)
Sample 3 (1000000 Vertices , 7MB)
Sample 4 (5000000 Vertices , 37MB)

CSV

	<head_1>,<tail_1>,<weight_1>

	.
	.
	.
		
	<head_n>,<tail_n>,<weight_n>

Document
Sample 1 (100 Vertices , 3KB)
Sample 2 (1000 Vertices , 51KB)

TSV

	<head_1>	<tail_1>	<weight_1>

	.
	.
	.
		
	<head_n>	<tail_n>	<weight_n>

Document
Sample 1 (100 Vertices , 29KB)
Sample 2 (1000 Vertices , 420KB)

JSON

{
	"properties": {
		"directed": true,
		"signed": true,
		"multigraph": true,
		"weighted": true,
		"self_loop": true
	},
	"graph": {
		"nodes":[
		{
			"id": 1
		},

		.
		.
		.

		{
			"id": n
		}
		],
		"edges":[
		{
			"source": head_1,
			"target": tail_1,
			"weight": weight_1
		},

		.
		.
		.

		{
			"source": head_n,
			"target": tail_n,
			"weight": weight_n
		}
		]
	}
}

Document
Sample 1 (100 Vertices , 26KB)
Sample 2 (1000 Vertices , 494KB)

YAML

 	graph:
 		edges:
 		- source: head_1
 	  	target: tail_1
 	  	weight: weight_1
 	
 		.
 		.
 		.

 		- source: head_n
 	  	target: tail_n
 	  	weight: weight_n
 					
 		nodes:
 		- id: 1

 		.
 		.
 		.

 		- id: n
 	properties:
 		directed: true
 		multigraph: true
 		self_loop: true
 		signed: true
 		weighted: true

Document
Sample 1 (30 Vertices , 6KB)
Sample 2 (100 Vertices , 35KB)

Weighted Edge List

	<head_1> <tail_1> <weight_1>
		
	.
	.
	.
		
	<head_n> <tail_n> <weight_n>

Document
Sample 1 (100 Vertices , 5KB)
Sample 2 (1000 Vertices , 192KB)

ASP

	node(1).
	.
	.
	.
	node(n).
	edge(head_1,tail_1,weight_1).
	.
	.
	.
	edge(head_n,tail_n,weight_n).

Document
Sample 1 (100 Vertices , 7KB)
Sample 2 (1000 Vertices , 76KB)

Trivial Graph Format

	1
	.
	.
	.
	n
	#
	1 2 weight_1
	.
	.
	.
	n k weight_n

Document
Sample 1 (100 Vertices , 4KB)
Sample 2 (1000 Vertices , 61KB)

UCINET DL Format

	dl
	format=edgelist1
	n=<number of vertices>
	data:
	1 2 weight_1
	.
	.
	.
	n k weight_n

Document
Sample 1 (100 Vertices , 8KB)
Sample 2 (1000 Vertices , 729KB)

Matrix Market

    %%MatrixMarket matrix coordinate real general
    <number of vertices>  <number of vertices>  <number of edges>
    <head_1>    <tail_1>    <weight_1> 
    .
    .
    .
    <head_n>    <tail_n>    <weight_n>

Document
Sample 1 (100 Vertices , 59KB)
Sample 2 (1000 Vertices , 1.8MB)

Graph Line

	<head_1> <tail_1>:<weight_1> <tail_2>:<weight_2>  ... <tail_n>:<weight_n>
	<head_2> <tail_1>:<weight_1> <tail_2>:<weight_2>  ... <tail_n>:<weight_n>
	.
	.
	.
	<head_n> <tail_1>:<weight_1> <tail_2>:<weight_2>  ... <tail_n>:<weight_n>

Sample 1 (100 Vertices , 17KB)
Sample 2 (1000 Vertices , 2.4MB)

GDF

    nodedef>name VARCHAR,label VARCHAR
    node_1,node_1_label
    node_2,node_2_label
    .
    .
    .
    node_n,node_n_label
    edgedef>node1 VARCHAR,node2 VARCHAR, weight DOUBLE
    node_1,node_2,weight_1
    node_1,node_3,weight_2
    .
    .
    .
    node_n,node_2,weight_n

Sample 1 (100 Vertices , 21KB)
Sample 2 (1000 Vertices , 690KB)

GML

    graph
    [
      multigraph 0
      directed  0
      node
      [
       id 1
       label "Node 1"
      ]
      node
      [
       id 2
       label "Node 2"
      ]
      .
      .
      .
      node
      [
       id n
       label "Node n"
      ]
      edge
      [
       source 1
       target 2
       value W1
      ]
      edge
      [
       source 2
       target 4
       value W2
      ]
      .
      .
      .
      edge
      [
       source n
       target r
       value Wn
      ]
    ]

Document
Sample 1 (100 Vertices , 120KB)
Sample 2 (1000 Vertices , 2.4MB)

GEXF

     <?xml version="1.0" encoding="UTF-8"?>
     <gexf xmlns="http://www.gexf.net/1.2draft" version="1.2">
         <meta lastmodifieddate="2009-03-20">
             <creator>PyRGG</creator>
             <description>File Name</description>
         </meta>
         <graph defaultedgetype="directed">
             <nodes>
                 <node id="1" label="Node 1" />
                 <node id="2" label="Node 2" />
                 ...
             </nodes>
             <edges>
                 <edge id="1" source="1" target="2" weight="400" />
                 ...
             </edges>
         </graph>
     </gexf>

Document
Sample 1 (100 Vertices , 63KB)
Sample 2 (1000 Vertices , 6.4MB)

Graphviz

	graph example 
		{
		node1 -- node2 [weight=W1];
		node3 -- node4 [weight=W2];
		node1 -- node3 [weight=W3];
		.
		.
		.
		}

Document
Sample 1 (100 Vertices , 11KB)
Sample 2 (1000 Vertices , 106KB)
Online Visualization

Pickle

⚠️ Binary format

Document
Sample 1 (100 Vertices , 12KB)
Sample 2 (1000 Vertices , 340KB)

Example of Usage

Generate synthetic data for graph processing frameworks (some of them mentioned here) performance-analysis
- Medusa
- Totem
- Frog
- CuSha
Generate synthetic data for graph benchmark suite like GAP

Similar Works

Random Modular Network Generator Generates random graphs with tunable strength of community structure
randomGraph very simple random graph generator in MATLAB
Graph1 Random Graph Generator with Max capacity paths (C++)

Issues & Bug Reports

Just fill an issue and describe it. We'll check it ASAP! or send an email to [email protected].

You can also join our discord server

Citing

If you use pyrgg in your research, please cite the JOSS paper ;-)

References

Logo designed by Zahra Mobasher

Show Your Support

Give a ⭐️ if this project helped you!

If you do like our project and we hope that you do, can you please support us? Our project is not and is never going to be working for profit. We need the money just so we can continue doing what we do ;-) .

Package Rankings

Top 10.62% on Pypi.org