Skip to content

Commit 12a50cc

Browse files
Merge pull request #65 from pnnl/develop
Develop
2 parents 5616e01 + 885e3fe commit 12a50cc

File tree

156 files changed

+224880
-6566
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

156 files changed

+224880
-6566
lines changed

.gitignore

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
.DS_Store
22
gitmerge.sh
33
dist
4-
hypernetx.egg-info
4+
hypernetx.egg-info*
55

66
stashmerge.sh
77
homology_log.log

README.md

Lines changed: 41 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -43,107 +43,114 @@ PNNL is operated by Battelle Memorial Institute under Contract DE-ACO5-76RL01830
4343
* High Performance Computing: Tony Liu, Andrew Lumsdaine
4444
* Principal Investigator: Cliff Joslyn
4545
* Program Manager: Mark Raugas, Brian Kritzstein
46-
* Mathematics, methods, and algorithms: Sinan Aksoy, Dustin Arendt, Cliff Joslyn, Andrew Lumsdaine, Tony Liu, Brenda Praggastis, and Emilie Purvine
46+
* Contributors: Sinan Aksoy, Dustin Arendt, Cliff Joslyn, Nicholas Landry, Andrew Lumsdaine, Tony Liu, Brenda Praggastis, Emilie Purvine, Mirah Shi, Francois Theberge
4747

4848
The code in this repository is intended to support researchers modeling data
4949
as hypergraphs. We have a growing community of users and contributors.
5050
Documentation is available at: <https://pnnl.github.io/HyperNetX/>
5151
For questions and comments contact the developers directly at:
52-
<hypernetx@pnnl.gov>
52+
<hypernetx@pnnl.gov>
5353

5454
New Features of Version 1.0
5555
---------------------------
5656

5757
1. Hypergraph construction can be sped up by reading in all of the data at once. In particular the hypergraph constructor may read a Pandas dataframe object and create edges and nodes based on column headers. The new hypergraphs are given an attribute `static=True`.
5858
2. A C++ addon called [NWHy](docs/build/nwhy.html) can be used in Linux environments to support optimized hypergraph methods such as s-centrality measures.
5959
3. A JavaScript addon called [Hypernetx-Widget](docs/build/widget.html) can be used to interactively inspect hypergraphs in a Jupyter Notebook.
60-
4. We've added four new tutorials highlighting the s-centrality metrics, static Hypergraphs, [NWHy](docs/build/nwhy.html), and [Hypernetx-Widget](docs/build/widget.html).
60+
4. Four new tutorials highlighting the s-centrality metrics, static Hypergraphs, [NWHy](docs/build/nwhy.html), and [Hypernetx-Widget](docs/build/widget.html).
61+
62+
New Features of Version 1.1
63+
---------------------------
64+
65+
1. Static Hypergraph refactored to improve performance across all methods.
66+
2. Added modules and tutorials for Contagion Modeling, Community Detection, Clustering, and Hypergraph Generation.
67+
3. Cell weights for incidence matrices may be added to static hypergraphs on construction.
6168

6269
Tutorials may be run in your browser using Google Colab
6370
-------------------------------------------------------
6471

6572
<a href="https://colab.research.google.com/github/pnnl/HyperNetX/blob/master/tutorials/Tutorial%201%20-%20HNX%20Basics.ipynb" target="_blank">
6673
<img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>
67-
<span >Tutorial 1 - HNX Basics</span>
74+
<span >Tutorial 1 - HNX Basics</span>
6875
</a>
6976
</br>
7077

7178
<a href="https://colab.research.google.com/github/pnnl/HyperNetX/blob/master/tutorials/Tutorial%202%20-%20Visualization%20Methods.ipynb" target="_blank">
7279
<img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>
73-
<span >Tutorial 2 - Visualization Methods</span>
80+
<span >Tutorial 2 - Visualization Methods</span>
7481
</a>
7582
</br>
7683

7784
<a href="https://colab.research.google.com/github/pnnl/HyperNetX/blob/master/tutorials/Tutorial%203%20-%20LesMis%20Case%20Study.ipynb" target="_blank">
7885
<img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>
79-
<span >Tutorial 3 - LesMis Case Study</span>
86+
<span >Tutorial 3 - LesMis Case Study</span>
8087
</a>
8188
</br>
8289

8390
<a href="https://colab.research.google.com/github/pnnl/HyperNetX/blob/master/tutorials/Tutorial%204%20-%20LesMis%20Visualizations-BookTour.ipynb" target="_blank">
8491
<img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>
85-
<span >Tutorial 4 - LesMis Visualizations-Book Tour</span>
92+
<span >Tutorial 4 - LesMis Visualizations-Book Tour</span>
8693
</a>
8794
</br>
8895

8996
<a href="https://colab.research.google.com/github/pnnl/HyperNetX/blob/master/tutorials/Tutorial%205%20-%20Homology%20mod%202%20for%20TriLoop%20Example.ipynb" target="_blank">
9097
<img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>
91-
<span >Tutorial 5 - Homology mod2 for TriLoop Example</span>
98+
<span >Tutorial 5 - Homology mod2 for TriLoop Example</span>
9299
</a>
93100
</br>
94101

95102
<a href="https://colab.research.google.com/github/pnnl/HyperNetX/blob/master/tutorials/Tutorial%206%20-%20Static%20Hypergraphs%20and%20Entities.ipynb" target="_blank">
96103
<img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>
97-
<span >Tutorial 6 - Static Hypergraphs and Entities</span>
104+
<span >Tutorial 6 - Static Hypergraphs and Entities</span>
98105
</a>
99106
</br>
100107

101108
<a href="https://colab.research.google.com/github/pnnl/HyperNetX/blob/master/tutorials/Tutorial%207%20-%20s-centrality.ipynb" target="_blank">
102109
<img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>
103-
<span >Tutorial 7 - s-Centrality</span>
110+
<span >Tutorial 7 - s-Centrality</span>
104111
</a>
105112
</br>
106-
113+
107114
Installing HyperNetX
108115
====================
109116
HyperNetX may be cloned or forked from: <https://github.com/pnnl/HyperNetX>
110117

111118
To install in an Anaconda environment
112119
-------------------------------------
113120

114-
>>> conda create -n <env name> python=3.7
115-
>>> source activate <env name>
116-
>>> pip install hypernetx
121+
>>> conda create -n <env name> python=3.7
122+
>>> source activate <env name>
123+
>>> pip install hypernetx
117124

118125
Mac Users: If you wish to build the documentation you will need
119126
the conda version of matplotlib:
120127

121-
>>> conda create -n <env name> python=3.7 matplotlib
122-
>>> source activate <env name>
123-
>>> pip install hypernetx
128+
>>> conda create -n <env name> python=3.7 matplotlib
129+
>>> source activate <env name>
130+
>>> pip install hypernetx
124131

125132
To use [NWHy](docs/build/nwhy.html) use python=3.9 and the conda version of tbb in your environment.
126133
**Note** that [NWHy](docs/build/nwhy.html) only works on Linux and some OSX systems. See [NWHy documentation](docs/build/nwhy.html) for more.:
127134

128-
>>> conda create -n <env name> python=3.9 tbb
129-
>>> source activate <env name>
130-
>>> pip install hypernetx
131-
>>> pip install nwhy
135+
>>> conda create -n <env name> python=3.9 tbb
136+
>>> source activate <env name>
137+
>>> pip install hypernetx
138+
>>> pip install nwhy
132139

133140
To install in a virtualenv environment
134141
--------------------------------------
135142

136-
>>> virtualenv --python=<path to python 3.7 executable> <path to env name>
143+
>>> virtualenv --python=<path to python 3.7 executable> <path to env name>
137144

138145
This will create a virtual environment in the specified location using
139146
the specified python executable. For example:
140147

141-
>>> virtualenv --python=C:\Anaconda3\python.exe hnx
148+
>>> virtualenv --python=C:\Anaconda3\python.exe hnx
142149

143150
This will create a virtual environment in .\hnx using the python
144151
that comes with Anaconda3.
145152

146-
>>> <path to env name>\Scripts\activate<file extension>
153+
>>> <path to env name>\Scripts\activate<file extension>
147154

148155
If you are running in Windows PowerShell use <file extension>=.ps1
149156

@@ -158,32 +165,32 @@ Install using Pip options
158165
-------------------------
159166
For a minimal installation:
160167

161-
>>> pip install hypernetx
168+
>>> pip install hypernetx
162169

163170
For an editable installation with access to jupyter notebooks:
164171

165172
>>> pip install [-e] .
166173

167174
To install with the tutorials:
168175

169-
>>> pip install -e .['tutorials']
176+
>>> pip install -e .['tutorials']
170177

171178
To install with the documentation:
172179

173-
>>> pip install -e .['documentation']
174-
>>> chmod 755 build_docs.sh
175-
>>> sh build_docs.sh
176-
## This will generate the documentation in /docs/build/
177-
## Open them in your browser with /docs/index.html
180+
>>> pip install -e .['documentation']
181+
>>> chmod 755 build_docs.sh
182+
>>> sh build_docs.sh
183+
## This will generate the documentation in /docs/build/
184+
## Open them in your browser with /docs/index.html
178185

179186
To install and test using pytest:
180187

181-
>>> pip install -e .['testing']
182-
>>> pytest
188+
>>> pip install -e .['testing']
189+
>>> pytest
183190

184191
To install the whole shabang:
185192

186-
>>> pip install -e .['all']
193+
>>> pip install -e .['all']
187194

188195
Notice
189196
------

docs/build/.buildinfo

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
# Sphinx build info version 1
22
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
3-
config: f9f9e2e79f610ea4d6452ca28dc1e9dc
3+
config: 3666e7e9b6d0ed402435e08580c5f834
44
tags: 645f666f9bcd5a90fca523b33c5a78b7
128 KB
Binary file not shown.
67.8 KB
Binary file not shown.
0 Bytes
Binary file not shown.
49.7 KB
Binary file not shown.
0 Bytes
Binary file not shown.

docs/build/.doctrees/core.doctree

0 Bytes
Binary file not shown.
-693 Bytes
Binary file not shown.

0 commit comments

Comments
 (0)