Revision 5cef0f13

View differences:

networkxMiCe/networkx-master/.appveyor.yml
1
# AppVeyor.com is a Continuous Integration service to build and run tests under
2
# Windows
3
# https://ci.appveyor.com/project/networkx/networkx
4

  
5
environment:
6
  global:
7
    # SDK v7.0 MSVC Express 2008's SetEnv.cmd script will fail if the
8
    # /E:ON and /V:ON options are not enabled in the batch script interpreter
9
    # See: http://stackoverflow.com/a/13751649/163740
10
    CMD_IN_ENV: "cmd /E:ON /V:ON /C .\\tools\\appveyor\\run_with_env.cmd"
11

  
12
  matrix:
13
    - PYTHON: "C:\\Python35"
14
      PYTHON_VERSION: "3.5.3"
15
      PYTHON_ARCH: "32"
16

  
17
    - PYTHON: "C:\\Python35-x64"
18
      PYTHON_VERSION: "3.5.3"
19
      PYTHON_ARCH: "64"
20

  
21
    - PYTHON: "C:\\Python36"
22
      PYTHON_VERSION: "3.6.6"
23
      PYTHON_ARCH: "32"
24

  
25
    - PYTHON: "C:\\Python36-x64"
26
      PYTHON_VERSION: "3.6.6"
27
      PYTHON_ARCH: "64"
28

  
29
    - PYTHON: "C:\\Python37"
30
      PYTHON_VERSION: "3.7.0"
31
      PYTHON_ARCH: "32"
32

  
33
    - PYTHON: "C:\\Python37-x64"
34
      PYTHON_VERSION: "3.7.0"
35
      PYTHON_ARCH: "64"
36

  
37
install:
38
  # Install Python (from the official .msi of http://python.org) and pip when
39
  # not already installed.
40
  - "powershell .\\tools\\appveyor\\install.ps1"
41
  - "SET PATH=%PYTHON%;%PYTHON%\\Scripts;%PATH%"
42

  
43
  # Check that we have the expected version and architecture for Python
44
  - "python --version"
45
  - "python -c \"import struct; print(struct.calcsize('P') * 8)\""
46

  
47
  # Install the build and runtime dependencies of the project.
48
  # - "%CMD_IN_ENV% pip install --timeout=60 -r requirements.txt"
49
  - "pip install ."
50

  
51
  - "pip install nose"
52

  
53
# Not a .NET project, we build networkx in the install step instead
54
build: false
55

  
56
test_script:
57
  # Change to a non-source folder to make sure we run the tests on the
58
  # installed library.
59
  - "pushd %TEMP%"
60
  - "nosetests --verbosity=2 networkx"
networkxMiCe/networkx-master/.codecov.yml
1
# Allow coverage to decrease by 0.05%.
2
coverage:
3
  status:
4
    project:
5
      default:
6
        threshold: 0.05%
7

  
8
# Don't post a comment on pull requests.
9
comment: off
networkxMiCe/networkx-master/.coveragerc
1
[run]
2
branch = True
3
source = networkx
4
omit = */tests/*, *release.py
networkxMiCe/networkx-master/.gitignore
1
*.pyc
2
__pycache__
3
*~
4
.DS_Store
5
build/*
6
dist/*
7
networkx/version.py
8
examples/*/*.png
9
doc/networkx-documentation.zip
10
doc/networkx_reference.pdf
11
doc/networkx_tutorial.pdf
12
doc/build
13
doc/ghpages_build
14
.coverage
15
*.class
16

  
17
# Generated while building documentation.
18
doc/auto_examples
19
doc/modules
20
doc/reference/generated
21
doc/reference/algorithms/generated
22
doc/reference/classes/generated
23
doc/reference/readwrite/generated
24
doc/path.to.file
25

  
26
examples/advanced/edgelist.utf-8
27
examples/basic/grid.edgelist
28

  
29
# Generated when 'python setup_egg.py'
30
networkx.egg-info/
31

  
32
# Sublime Text project files
33
*.sublime-project
34
*.sublime-workspace
35

  
36
# Backup files
37
*.bak
38

  
39
# IPython Notebook Checkpoints
40
.ipynb_checkpoints/
41

  
42
# Vim's swap files
43
*.sw[op]
44

  
45
#Spyder project file
46
.spyderproject
47

  
48
# PyCharm project file
49
.idea
50

  
51
# VS Code settings
52
.vscode
networkxMiCe/networkx-master/.mailmap
1
Aric Hagberg <aric.hagberg@gmail.com> aric
2
Aric Hagberg <aric.hagberg@gmail.com> aric <none@none>
3
Chris Ellison <cellison@cse.ucdavis.edu> cellison <none@none>
4
Dan Schult <dschult@colgate.edu> dschult <none@none>
networkxMiCe/networkx-master/.travis.yml
1
# After changing this file, check it on:
2
#   http://lint.travis-ci.org/
3
#
4
sudo: false
5

  
6
language: python
7

  
8
cache:
9
  directories:
10
    - $HOME/.cache/pip
11

  
12
matrix:
13
  include:
14
    - os: linux
15
      python: 3.7
16
      dist: xenial
17
      sudo: true
18
      env:
19
      - OPTIONAL_DEPS=1
20
      - BUILD_DOCS=1
21
      - DEPLOY_DOCS=1
22
      addons:
23
        apt:
24
          packages:
25
          - libgdal-dev
26
          - graphviz
27
          - texlive
28
          - texlive-latex-extra
29
          - latexmk
30
    - os: linux
31
      python: 3.7
32
      dist: xenial
33
      sudo: true
34
      env:
35
      - OPTIONAL_DEPS=1
36
      - MINIMUM_REQUIREMENTS=1
37
      - REPORT_COVERAGE=1
38
      addons:
39
        apt:
40
          packages:
41
          - libgdal-dev
42
          - graphviz
43
    - os: linux
44
      python: 3.7
45
      dist: xenial
46
      sudo: true
47
      env:
48
      - OPTIONAL_DEPS=1
49
      - PIP_FLAGS="--pre"
50
      addons:
51
        apt:
52
          packages:
53
          - libgdal-dev
54
          - graphviz
55
    - os: osx
56
      osx_image: xcode7.3
57
      language: generic
58
      env:
59
      - TRAVIS_PYTHON_VERSION=3.6.1
60
      - OPTIONAL_DEPS=1
61
      - OSX_PKG_ENV=miniconda
62
    - os: osx
63
      language: generic
64
      env: TRAVIS_PYTHON_VERSION=3.7
65
    - python: 3.5
66
    - python: 3.6
67
    - python: 3.7
68
      dist: xenial
69
      sudo: true
70

  
71
before_install:
72
  # prepare the system to install prerequisites or dependencies
73
  - source tools/travis/before_install.sh
74
  - uname -a
75
  - printenv
76
  - if [[ "${TRAVIS_OS_NAME}" == "osx" ]]; then
77
      source tools/travis/osx_install.sh;
78
    else
79
      source tools/travis/linux_install.sh;
80
    fi
81

  
82
install:
83
  # install required packages
84
  - pip install --upgrade pip
85
  - pip install --retries 3 ${PIP_FLAGS} -r requirements.txt
86
  - if [[ "${OPTIONAL_DEPS}" == 1 ]]; then
87
      pip install --retries 3 ${PIP_FLAGS} -r requirements/extras.txt;
88
    fi
89
  # install networkx
90
  - printenv PWD
91
  - pip install .
92
  # show what's installed
93
  - python --version
94
  - pip list
95

  
96
script:
97
  - if [[ "${BUILD_DOCS}" == 1 ]]; then
98
      source tools/travis/build_docs.sh;
99
    fi
100
  - source tools/travis/script.sh
101

  
102
after_success:
103
  - if [[ "${REPORT_COVERAGE}" == 1 ]]; then
104
      codecov;
105
    fi
106
  - if [[ "${BUILD_DOCS}" == 1 && "${DEPLOY_DOCS}" == 1 ]]; then
107
      source tools/travis/deploy_docs.sh;
108
    fi
109

  
110
notifications:
111
  email: false
networkxMiCe/networkx-master/CONTRIBUTING.rst
1
Developer overview
2
==================
3

  
4
1. If you are a first-time contributor:
5

  
6
   * Go to `https://github.com/networkx/networkx
7
     <https://github.com/networkx/networkx>`_ and click the
8
     "fork" button to create your own copy of the project.
9

  
10
   * Clone the project to your local computer::
11

  
12
      git clone git@github.com:your-username/networkx.git
13

  
14
   * Add the upstream repository::
15

  
16
      git remote add upstream git@github.com:networkx/networkx.git
17

  
18
   * Now, you have remote repositories named:
19

  
20
      - ``upstream``, which refers to the ``networkx`` repository
21
      - ``origin``, which refers to your personal fork
22

  
23
2. Develop your contribution:
24

  
25
   * Pull the latest changes from upstream::
26

  
27
      git checkout master
28
      git pull upstream master
29

  
30
   * Create a branch for the feature you want to work on. Since the
31
     branch name will appear in the merge message, use a sensible name
32
     such as 'bugfix-for-issue-1480'::
33

  
34
      git checkout -b bugfix-for-issue-1480
35

  
36
   * Commit locally as you progress (``git add`` and ``git commit``)
37

  
38
3. To submit your contribution:
39

  
40
   * Push your changes back to your fork on GitHub::
41

  
42
      git push origin bugfix-for-issue-1480
43

  
44
   * Go to GitHub. The new branch will show up with a green Pull Request
45
     button---click it.
46

  
47
   * If you want, post on the `mailing list
48
     <http://groups.google.com/group/networkx-discuss>`_ to explain your changes or
49
     to ask for review.
50

  
51
For a more detailed discussion, read these :doc:`detailed documents
52
<gitwash/index>` on how to use Git with ``networkx``
53
(`<https://networkx.github.io/documentation/latest/developer/gitwash/index.html>`_).
54

  
55
4. Review process:
56

  
57
    * Reviewers (the other developers and interested community members) will
58
      write inline and/or general comments on your Pull Request (PR) to help
59
      you improve its implementation, documentation, and style.  Every single
60
      developer working on the project has their code reviewed, and we've come
61
      to see it as friendly conversation from which we all learn and the
62
      overall code quality benefits.  Therefore, please don't let the review
63
      discourage you from contributing: its only aim is to improve the quality
64
      of project, not to criticize (we are, after all, very grateful for the
65
      time you're donating!).
66

  
67
    * To update your pull request, make your changes on your local repository
68
      and commit. As soon as those changes are pushed up (to the same branch as
69
      before) the pull request will update automatically.
70

  
71
    * `Travis-CI <https://travis-ci.org/>`_, a continuous integration service,
72
      is triggered after each Pull Request update to build the code and run unit
73
      tests of your branch. The Travis tests must pass before your PR can be merged.
74
      If Travis fails, you can find out why by clicking on the "failed" icon (red
75
      cross) and inspecting the build and test log.
76

  
77
    * `AppVeyor <http://ci.appveyor.com>`_, is another continuous integration
78
      service, which we use.  You will also need to make sure that the AppVeyor
79
      tests pass.
80

  
81
.. note::
82

  
83
   If closing a bug, also add "Fixes #1480" where 1480 is the issue number.
84

  
85
Divergence between ``upstream master`` and your feature branch
86
--------------------------------------------------------------
87

  
88
Never merge the main branch into yours. If GitHub indicates that the
89
branch of your Pull Request can no longer be merged automatically, rebase
90
onto master::
91

  
92
   git checkout master
93
   git pull upstream master
94
   git checkout bugfix-for-issue-1480
95
   git rebase master
96

  
97
If any conflicts occur, fix the according files and continue::
98

  
99
   git add conflict-file1 conflict-file2
100
   git rebase --continue
101

  
102
However, you should only rebase your own branches and must generally not
103
rebase any branch which you collaborate on with someone else.
104

  
105
Finally, you must push your rebased branch::
106

  
107
   git push --force origin bugfix-for-issue-1480
108

  
109
(If you are curious, here's a further discussion on the
110
`dangers of rebasing <http://tinyurl.com/lll385>`_.
111
Also see this `LWN article <http://tinyurl.com/nqcbkj>`_.)
112

  
113
Guidelines
114
----------
115

  
116
* All code should have tests.
117
* All code should be documented, to the same
118
  `standard <https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt#docstring-standard>`_
119
  as NumPy and SciPy.
120
* All changes are reviewed.  Ask on the
121
  `mailing list <http://groups.google.com/group/networkx-discuss>`_ if
122
  you get no response to your pull request.
123

  
124
Stylistic Guidelines
125
--------------------
126

  
127
* Set up your editor to remove trailing whitespace.
128
  Follow `PEP08 <www.python.org/dev/peps/pep-0008/>`_.
129
  Check code with `pyflakes` / `flake8`.
130

  
131
* Use the following import conventions::
132

  
133
   import numpy as np
134
   import scipy as sp
135
   import matplotlib as mpl
136
   import matplotlib.pyplot as plt
137
   import networkx as nx
138

  
139
   cimport numpy as cnp # in Cython code
140

  
141
Pull request codes
142
------------------
143

  
144
When you submit a pull request to GitHub, GitHub will ask you for a summary.  If
145
your code is not ready to merge, but you want to get feedback, please consider
146
using ``WIP: experimental optimization`` or similar for the title of your pull
147
request. That way we will all know that it's not yet ready to merge and that
148
you may be interested in more fundamental comments about design.
149

  
150
When you think the pull request is ready to merge, change the title (using the
151
*Edit* button) to remove the ``WIP:``.
152

  
153
Developer Notes
154
---------------
155

  
156
For additional information about contributing to NetworkX, please see
157
the `Developer Notes <https://github.com/networkx/networkx/wiki>`_.
158

  
159
Bugs
160
----
161

  
162
Please `report bugs on GitHub <https://github.com/networkx/networkx/issues>`_.
networkxMiCe/networkx-master/CONTRIBUTORS.rst
1
Credits
2
=======
3

  
4
NetworkX was originally written by Aric Hagberg, Dan Schult, and Pieter Swart,
5
and has been developed with the help of many others. Thanks to everyone who has
6
improved NetworkX by contributing code, bug reports (and fixes), documentation,
7
and input on design, features, and the future of NetworkX.
8

  
9
Contributions
10
-------------
11

  
12
This section aims to provide a list of people and projects that have
13
contributed to ``networkx``. It is intended to be an *inclusive* list, and
14
anyone who has contributed and wishes to make that contribution known is
15
welcome to add an entry into this file.  Generally, no name should be added to
16
this list without the approval of the person associated with that name.
17

  
18
Creating a comprehensive list of contributors can be difficult, and the list
19
within this file is almost certainly incomplete.  Contributors include
20
testers, bug reporters, contributors who wish to remain anonymous, funding
21
sources, academic advisors, end users, and even build/integration systems (such
22
as `TravisCI <https://travis-ci.org>`_).
23

  
24
Do you want to make your contribution known? If you have commit access, edit
25
this file and add your name. If you do not have commit access, feel free to
26
open an `issue <https://github.com/networkx/networkx/issues/new>`_, submit a
27
`pull request <https://github.com/networkx/networkx/compare/>`_, or get in
28
contact with one of the official team
29
`members <https://github.com/networkx?tab=members>`_.
30

  
31
A supplementary (but still incomplete) list of contributors is given by the
32
list of names that have commits in ``networkx``'s
33
`git <http://git-scm.com>`_ repository. This can be obtained via::
34

  
35
    git log --raw | grep "^Author: " | sort | uniq
36

  
37
A historical, partial listing of contributors and their contributions to some
38
of the earlier versions of NetworkX can be found
39
`here <https://github.com/networkx/networkx/blob/886e790437bcf30e9f58368829d483efef7a2acc/doc/source/reference/credits_old.rst>`_.
40

  
41

  
42
Original Authors
43
^^^^^^^^^^^^^^^^
44

  
45
| Aric Hagberg
46
| Dan Schult
47
| Pieter Swart
48
|
49

  
50

  
51
Contributors
52
^^^^^^^^^^^^
53

  
54
Optionally, add your desired name and include a few relevant links. The order
55
is partially historical, and now, mostly arbitrary.
56

  
57
- Aric Hagberg, GitHub: `hagberg <https://github.com/hagberg>`_
58
- Dan Schult, GitHub: `dschult <https://github.com/dschult>`_
59
- Pieter Swart
60
- Katy Bold
61
- Hernan Rozenfeld
62
- Brendt Wohlberg
63
- Jim Bagrow
64
- Holly Johnsen
65
- Arnar Flatberg
66
- Chris Myers
67
- Joel Miller
68
- Keith Briggs
69
- Ignacio Rozada
70
- Phillipp Pagel
71
- Sverre Sundsdal
72
- Ross M. Richardson
73
- Eben Kenah
74
- Sasha Gutfriend
75
- Udi Weinsberg
76
- Matteo Dell'Amico
77
- Andrew Conway
78
- Raf Guns
79
- Salim Fadhley
80
- Fabrice Desclaux
81
- Arpad Horvath
82
- Minh Van Nguyen
83
- Willem Ligtenberg
84
- Loïc Séguin-C.
85
- Paul McGuire
86
- Jesus Cerquides
87
- Ben Edwards
88
- Jon Olav Vik
89
- Hugh Brown
90
- Ben Reilly
91
- Leo Lopes
92
- Jordi Torrents, GitHub: `jtorrents <https://github.com/jtorrents>`_
93
- Dheeraj M R
94
- Franck Kalala
95
- Simon Knight
96
- Conrad Lee
97
- Sérgio Nery Simões
98
- Robert King
99
- Nick Mancuso
100
- Brian Cloteaux
101
- Alejandro Weinstein
102
- Dustin Smith
103
- Mathieu Larose
104
- Romain Fontugne
105
- Vincent Gauthier
106
- chebee7i, GitHub: `chebee7i <https://github.com/chebee7i>`_
107
- Jeffrey Finkelstein
108
- Jean-Gabriel Young, Github: `jg-you <https://github.com/jgyou>`_
109
- Andrey Paramonov, http://aparamon.msk.ru
110
- Mridul Seth, GitHub: `MridulS <https://github.com/MridulS>`_
111
- Thodoris Sotiropoulos, GitHub: `theosotr <https://github.com/theosotr>`_
112
- Konstantinos Karakatsanis, GitHub: `k-karakatsanis <https://github.com/k-karakatsanis>`_
113
- Ryan Nelson, GitHub: `rnelsonchem <https://github.com/rnelsonchem>`_
114
- Niels van Adrichem, GitHub: `NvanAdrichem <https://github.com/NvanAdrichem>`_
115
- Michael E. Rose, GitHub: `Michael-E-Rose <https://github.com/Michael-E-Rose>`_
116
- Jarrod Millman, GitHub: `jarrodmillman <https://github.com/jarrodmillman>`_
117
- Andre Weltsch
118
- Lewis Robbins
119
- Mads Jensen, Github: `atombrella <https://github.com/atombrella>`_
120
- Edward L. Platt, `elplatt <https://elplatt.com>`_
121
- James Owen, Github: `leamingrad <https://github.com/leamingrad>`_
122
- Robert Gmyr, Github: `gmyr <https://github.com/gmyr>`_
123
- Mike Trenfield
124
- Jon Crall, Github: `Erotemic <https://github.com/Erotemic>`_
125
- Issa Moradnejad, `Github <https://github.com/Moradnejad>`_, `LinkedIn <https://linkedin.com/in/moradnejad/>`_
126
- Brian Kiefer, Github: `bkief <https://github.com/bkief>`_
127
- Julien Klaus
128
- Weisheng Si, Github: `ws4u <https://github.com/ws4u>`_
129
- Haakon H. Rød, Gitlab: `haakonhr <https://gitlab.com/haakonhr>`_, `<https://haakonhr.gitlab.io>`_ 
130
- Efraim Rodrigues, `GitHub <https://github.com/efraimrodrigues>`_, `LinkedIn <https://linkedin.com/in/efraim-rodrigues/>`_
131

  
132
Support
133
-------
134

  
135
``networkx`` and those who have contributed to ``networkx`` have received
136
support throughout the years from a variety of sources.  We list them below.
137
If you have provided support to ``networkx`` and a support acknowledgment does
138
not appear below, please help us remedy the situation, and similarly, please
139
let us know if you'd like something modified or corrected.
140

  
141
Research Groups
142
^^^^^^^^^^^^^^^
143

  
144
``networkx`` acknowledges support from the following:
145

  
146
- `Center for Nonlinear Studies <http://cnls.lanl.gov>`_, Los Alamos National
147
  Laboratory, PI: Aric Hagberg
148

  
149
- `Open Source Programs Office <https://developers.google.com/open-source/>`_,
150
  Google
151

  
152
- `Complexity Sciences Center <http://csc.ucdavis.edu/>`_, Department of
153
  Physics, University of California-Davis, PI: James P. Crutchfield
154

  
155
- `Center for Complexity and Collective Computation <http://c4.discovery.wisc.edu>`_,
156
  Wisconsin Institute for Discovery, University of Wisconsin-Madison,
157
  PIs: Jessica C. Flack and David C. Krakauer
158

  
159
Funding
160
^^^^^^^
161

  
162
``networkx`` acknowledges support from the following:
163

  
164
- Google Summer of Code via Python Software Foundation
165

  
166
- U.S. Army Research Office grant W911NF-12-1-0288
167

  
168
- DARPA Physical Intelligence Subcontract No. 9060-000709
169

  
170
- NSF Grant No. PHY-0748828
171

  
172
- John Templeton Foundation through a grant to the Santa Fe Institute to
173
  study complexity
174

  
175
- U.S. Army Research Laboratory and the U.S. Army Research Office under
176
  contract number W911NF-13-1-0340
networkxMiCe/networkx-master/INSTALL.rst
1
Install
2
=======
3

  
4
NetworkX requires Python 3.5, 3.6, or 3.7.  If you do not already
5
have a Python environment configured on your computer, please see the
6
instructions for installing the full `scientific Python stack
7
<https://scipy.org/install.html>`_.
8

  
9
.. note::
10
   If you are on Windows and want to install optional packages (e.g., `scipy`),
11
   then you will need to install a Python distribution such as
12
   `Anaconda <https://www.anaconda.com/download/>`_,
13
   `Enthought Canopy <https://www.enthought.com/product/canopy>`_,
14
   `Python(x,y) <http://python-xy.github.io/>`_,
15
   `WinPython <https://winpython.github.io/>`_, or
16
   `Pyzo <http://www.pyzo.org/>`_.
17
   If you use one of these Python distribution, please refer to their online
18
   documentation.
19

  
20
Below we assume you have the default Python environment already configured on
21
your computer and you intend to install ``networkx`` inside of it.  If you want
22
to create and work with Python virtual environments, please follow instructions
23
on `venv <https://docs.python.org/3/library/venv.html>`_ and `virtual
24
environments <http://docs.python-guide.org/en/latest/dev/virtualenvs/>`_.
25

  
26
First, make sure you have the latest version of ``pip`` (the Python package manager)
27
installed. If you do not, refer to the `Pip documentation
28
<https://pip.pypa.io/en/stable/installing/>`_ and install ``pip`` first.
29

  
30
Install the released version
31
----------------------------
32

  
33
Install the current release of ``networkx`` with ``pip``::
34

  
35
    $ pip install networkx
36

  
37
To upgrade to a newer release use the ``--upgrade`` flag::
38

  
39
    $ pip install --upgrade networkx
40

  
41
If you do not have permission to install software systemwide, you can
42
install into your user directory using the ``--user`` flag::
43

  
44
    $ pip install --user networkx
45

  
46
Alternatively, you can manually download ``networkx`` from
47
`GitHub <https://github.com/networkx/networkx/releases>`_  or
48
`PyPI <https://pypi.python.org/pypi/networkx>`_.
49
To install one of these versions, unpack it and run the following from the
50
top-level source directory using the Terminal::
51

  
52
    $ pip install .
53

  
54
Install the development version
55
-------------------------------
56

  
57
If you have `Git <https://git-scm.com/>`_ installed on your system, it is also
58
possible to install the development version of ``networkx``.
59

  
60
Before installing the development version, you may need to uninstall the
61
standard version of ``networkx`` using ``pip``::
62

  
63
    $ pip uninstall networkx
64

  
65
Then do::
66

  
67
    $ git clone https://github.com/networkx/networkx.git
68
    $ cd networkx
69
    $ pip install -e .
70

  
71
The ``pip install -e .`` command allows you to follow the development branch as
72
it changes by creating links in the right places and installing the command
73
line scripts to the appropriate locations.
74

  
75
Then, if you want to update ``networkx`` at any time, in the same directory do::
76

  
77
    $ git pull
78

  
79
Optional packages
80
-----------------
81

  
82
.. note::
83
   Some optional packages (e.g., `scipy`, `gdal`) may require compiling
84
   C or C++ code.  If you have difficulty installing these packages
85
   with `pip`, please review the instructions for installing
86
   the full `scientific Python stack <https://scipy.org/install.html>`_.
87

  
88
The following optional packages provide additional functionality.
89

  
90
- `NumPy <http://www.numpy.org/>`_ (>= 1.15.4) provides matrix representation of
91
  graphs and is used in some graph algorithms for high-performance matrix
92
  computations.
93
- `SciPy <http://scipy.org/>`_ (>= 1.1.0) provides sparse matrix representation
94
  of graphs and many numerical scientific tools.
95
- `pandas <http://pandas.pydata.org/>`_ (>= 0.23.3) provides a DataFrame, which
96
  is a tabular data structure with labeled axes.
97
- `Matplotlib <http://matplotlib.org/>`_ (>= 3.0.2) provides flexible drawing of
98
  graphs.
99
- `PyGraphviz <http://pygraphviz.github.io/>`_ (>= 1.5) and
100
  `pydot <https://github.com/erocarrera/pydot>`_ (>= 1.2.4) provide graph drawing
101
  and graph layout algorithms via `GraphViz <http://graphviz.org/>`_.
102
- `PyYAML <http://pyyaml.org/>`_ provides YAML format reading and writing.
103
- `gdal <http://www.gdal.org/>`_ provides shapefile format reading and writing.
104
- `lxml <http://lxml.de/>`_ used for GraphML XML format.
105

  
106
To install ``networkx`` and all optional packages, do::
107

  
108
    $ pip install networkx[all]
109

  
110
To explicitly install all optional packages, do::
111

  
112
    $ pip install numpy scipy pandas matplotlib pygraphviz pydot pyyaml gdal
113

  
114
Or, install any optional package (e.g., ``numpy``) individually::
115

  
116
    $ pip install numpy
117

  
118
Testing
119
-------
120

  
121
NetworkX uses the Python ``nose`` testing package.  If you don't already have
122
that package installed, follow the directions on the `nose homepage
123
<https://nose.readthedocs.org/>`_.
124

  
125
Test a source distribution
126
^^^^^^^^^^^^^^^^^^^^^^^^^^
127

  
128
You can test the complete package from the unpacked source directory with::
129

  
130
    nosetests networkx -v
131

  
132
Test an installed package
133
^^^^^^^^^^^^^^^^^^^^^^^^^
134

  
135
If you have a file-based (not a Python egg) installation you can test the
136
installed package with::
137

  
138
    >>> import networkx as nx
139
    >>> nx.test()
140

  
141
or::
142

  
143
    python -c "import networkx as nx; nx.test()"
144

  
145
.. autofunction:: networkx.test
146

  
147
Testing for developers
148
^^^^^^^^^^^^^^^^^^^^^^
149

  
150
You can test any or all of NetworkX by using the ``nosetests`` test runner.
151

  
152
First make sure the NetworkX version you want to test is in your ``PYTHONPATH``
153
(either installed or pointing to your unpacked source directory).
154

  
155
Then you can run individual test files with::
156

  
157
    nosetests path/to/file
158

  
159
or all tests found in dir and an directories contained in dir::
160

  
161
    nosetests path/to/dir
162

  
163
By default nosetests does not test docutils style tests in
164
Python modules but you can turn that on with::
165

  
166
    nosetests --with-doctest
167

  
168
For doctests in stand-alone files NetworkX uses the extension ``txt`` so
169
you can add::
170

  
171
    nosetests --with-doctest --doctest-extension=txt
172

  
173
to also execute those tests.
174

  
175
These options are on by default if you run nosetests from the root of the
176
NetworkX distribution since they are specified in the ``setup.cfg`` file found
177
there.
networkxMiCe/networkx-master/LICENSE.txt
1
License
2
=======
3

  
4
NetworkX is distributed with the 3-clause BSD license.
5

  
6
::
7

  
8
   Copyright (C) 2004-2019, NetworkX Developers
9
   Aric Hagberg <hagberg@lanl.gov>
10
   Dan Schult <dschult@colgate.edu>
11
   Pieter Swart <swart@lanl.gov>
12
   All rights reserved.
13

  
14
   Redistribution and use in source and binary forms, with or without
15
   modification, are permitted provided that the following conditions are
16
   met:
17

  
18
     * Redistributions of source code must retain the above copyright
19
       notice, this list of conditions and the following disclaimer.
20

  
21
     * Redistributions in binary form must reproduce the above
22
       copyright notice, this list of conditions and the following
23
       disclaimer in the documentation and/or other materials provided
24
       with the distribution.
25

  
26
     * Neither the name of the NetworkX Developers nor the names of its
27
       contributors may be used to endorse or promote products derived
28
       from this software without specific prior written permission.
29

  
30
   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
31
   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
32
   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
33
   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
34
   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
35
   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
36
   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
37
   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
38
   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
39
   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
40
   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
networkxMiCe/networkx-master/MANIFEST.in
1
include MANIFEST.in
2
include setup.py
3
include CONTRIBUTING.rst
4
include CONTRIBUTORS.rst
5
include INSTALL.rst
6
include LICENSE.txt
7
include README.rst
8
include RELEASE.rst
9

  
10
recursive-include examples *.txt *.py *.edgelist *.mbox *.gz *.bz2 *.zip *.html *.js *.css
11
recursive-include doc *.py *.rst Makefile *.html *.png *.txt *.css *.inc *.js
12

  
13
include networkx/tests/*.py
14
include networkx/*/tests/*.txt
15
include networkx/*/tests/*.py
16
include networkx/*/*/tests/*.py
17
include networkx/*/*/tests/*.A99
18
include networkx/*/*/tests/*.B99
19
include networkx/*/*/tests/*.bz2
20
global-exclude *~
21
global-exclude *.pyc
22
global-exclude .svn
23

  
24
prune doc/build
25
prune doc/auto_examples
26
prune doc/modules
27
prune doc/reference/generated
28
prune doc/reference/algorithms/generated
29
prune doc/reference/classes/generated
30
prune doc/reference/readwrite/generated
networkxMiCe/networkx-master/README.rst
1
NetworkX
2
========
3

  
4
.. image:: https://travis-ci.org/networkx/networkx.svg?branch=master
5
   :target: https://travis-ci.org/networkx/networkx
6

  
7
.. image:: https://ci.appveyor.com/api/projects/status/github/networkx/networkx?branch=master&svg=true
8
   :target: https://ci.appveyor.com/project/dschult/networkx-pqott
9

  
10
.. image:: https://codecov.io/gh/networkx/networkx/branch/master/graph/badge.svg
11
  :target: https://codecov.io/gh/networkx/networkx
12

  
13
NetworkX is a Python package for the creation, manipulation,
14
and study of the structure, dynamics, and functions
15
of complex networks.
16

  
17
- **Website (including documentation):** http://networkx.github.io
18
- **Mailing list:** https://groups.google.com/forum/#!forum/networkx-discuss
19
- **Source:** https://github.com/networkx/networkx
20
- **Bug reports:** https://github.com/networkx/networkx/issues
21

  
22
Install
23
-------
24

  
25
Install the latest version of NetworkX::
26

  
27
    $ pip install networkx
28

  
29
Install with all optional dependencies::
30

  
31
    $ pip install networkx[all]
32

  
33
For additional details, please see `INSTALL.rst`.
34

  
35
Simple example
36
--------------
37

  
38
Find the shortest path between two nodes in an undirected graph:
39

  
40
.. code:: python
41

  
42
    >>> import networkx as nx
43
    >>> G = nx.Graph()
44
    >>> G.add_edge('A', 'B', weight=4)
45
    >>> G.add_edge('B', 'D', weight=2)
46
    >>> G.add_edge('A', 'C', weight=3)
47
    >>> G.add_edge('C', 'D', weight=4)
48
    >>> nx.shortest_path(G, 'A', 'D', weight='weight')
49
    ['A', 'B', 'D']
50

  
51
Bugs
52
----
53

  
54
Please report any bugs that you find `here <https://github.com/networkx/networkx/issues>`_.
55
Or, even better, fork the repository on `GitHub <https://github.com/networkx/networkx>`_
56
and create a pull request (PR). We welcome all changes, big or small, and we
57
will help you make the PR if you are new to `git` (just ask on the issue and/or
58
see `CONTRIBUTING.rst`).
59

  
60
License
61
-------
62

  
63
Released under the 3-Clause BSD license (see `LICENSE.txt`)::
64

  
65
   Copyright (C) 2004-2019 NetworkX Developers
66
   Aric Hagberg <hagberg@lanl.gov>
67
   Dan Schult <dschult@colgate.edu>
68
   Pieter Swart <swart@lanl.gov>
networkxMiCe/networkx-master/RELEASE.rst
1
How to make a new release of ``networkx``
2
=========================================
3

  
4
- Update the release notes:
5

  
6
  1. Review and cleanup ``doc/release/release_dev.rst``,
7

  
8
  2. Fix code in documentation by running
9
     ``cd doc && make doctest``.
10

  
11
  3. Make a list of merges and contributors by running
12
     ``doc/release/contribs.py <tag of previous release>``.
13

  
14
  4. Paste this list at the end of the ``release_dev.rst``. Scan the PR titles
15
     for highlights, deprecations, and API changes, and mention these in the
16
     relevant sections of the notes.
17

  
18
  5. Rename to ``doc/release/release_<major>.<minor>.rst``.
19

  
20
  6. Copy ``doc/release/release_template.rst`` to
21
     ``doc/release/release_dev.rst`` for the next release.
22

  
23
  7. Update ``doc/news.rst``.
24

  
25
- Toggle ``dev = True`` to ``dev = False`` in ``networkx/release.py``.
26

  
27
- Commit changes.
28

  
29
- Add the version number as a tag in git::
30

  
31
   git tag -s [-u <key-id>] networkx-<major>.<minor>
32

  
33
  (If you do not have a gpg key, use -m instead; it is important for
34
  Debian packaging that the tags are annotated)
35

  
36
- Push the new meta-data to github::
37

  
38
   git push --tags upstream master
39

  
40
  (where ``upstream`` is the name of the
41
   ``github.com:networkx/networkx`` repository.)
42

  
43
- Review the github release page::
44

  
45
  https://github.com/networkx/networkx/releases
46

  
47
- Publish on PyPi::
48

  
49
   git clean -fxd
50
   python setup.py sdist --formats=zip
51
   twine upload -s dist/networkx*.zip
52

  
53
- Update documentation on the web:
54
  The documentation is kept in a separate repo: networkx/documentation
55

  
56
  - Wait for the NetworkX Travis Bot to deploy to GitHub Pages
57
  - Sync your branch with the remote repo: ``git pull``.
58
  - Copy the documentation built by Travis.
59
    Assuming you are at the top-level of the ``documentation`` repo::
60

  
61
      cp -a latest networkx-<major>.<minor> 
62
      git add networkx-<major>.<minor>
63
      ln -sfn networkx-<major>.<minor> stable
64
      git commit -m "Add <major>.<minor> docs"
65
      # maybe squash all the Deploy GitHub Pages commits
66
      # git rebase -i HEAD~XX where XX is the number of commits back
67
      # check you didn't break anything
68
      # diff -r latest networkx-<major>.<minor>
69
      # you will then need to force the push so be careful!
70
      git push
71

  
72
 - Increase the version number
73

  
74
  - Toggle ``dev = False`` to ``dev = True`` in ``networkx/release.py``.
75
  - Update ``major`` and ``minor`` in ``networkx/release.py``.
76

  
77
- Update the web frontpage:
78
  The webpage is kept in a separate repo: networkx/website
79

  
80
  - Sync your branch with the remote repo: ``git pull``.
81
    If you try to ``make github`` when your branch is out of sync, it
82
    creates headaches.
83
  - Update ``_templates/sidebar_versions.html``.
84
  - Edit ``_static/docversions.js`` and commit
85
  - Push your changes to the repo.
86
  - Deploy using ``make github``.
87

  
88
- Post release notes on mailing list.
89

  
90
  - networkx-discuss@googlegroups.com
networkxMiCe/networkx-master/doc/Makefile
1
# Makefile for Sphinx documentation
2
#
3

  
4
# You can set these variables from the command line.
5
SPHINXOPTS    =
6
SPHINXBUILD   = sphinx-build
7
PAPER         =
8

  
9
# Internal variables.
10
PAPEROPT_a4     = -D latex_paper_size=a4
11
PAPEROPT_letter = -D latex_paper_size=letter
12
ALLSPHINXOPTS   = -d build/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
13

  
14
.PHONY: help clean html dirhtml pickle json htmlhelp qthelp latex changes linkcheck doctest epub
15

  
16
help:
17
	@echo "Please use \`make <target>' where <target> is one of"
18
	@echo "  html      to make standalone HTML files"
19
	@echo "  dirhtml   to make HTML files named index.html in directories"
20
	@echo "  pickle    to make pickle files"
21
	@echo "  epub       to make an epub"
22
	@echo "  json      to make JSON files"
23
	@echo "  htmlhelp  to make HTML files and a HTML help project"
24
	@echo "  qthelp    to make HTML files and a qthelp project"
25
	@echo "  latex     to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
26
	@echo "  changes   to make an overview of all changed/added/deprecated items"
27
	@echo "  linkcheck to check all external links for integrity"
28
	@echo "  doctest   to run all doctests embedded in the documentation (if enabled)"
29
	@echo "  gitwash   to update the gitwash documentation"
30

  
31

  
32
clean:
33
	-rm -rf build/*
34
	-rm -rf ghpages_build
35
	-rm -rf auto_examples modules
36
	-rm -rf reference/generated reference/algorithms/generated reference/classes/generated reference/readwrite/generated
37

  
38
dist: html
39
	test -d build/latex || make latex
40
	make -C build/latex all-pdf
41
	-rm -rf build/dist
42
	(cd build/html; cp -r . ../../build/dist)
43
	(cd build/dist && tar czf ../dist.tar.gz .)
44

  
45
html:
46
	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) build/html
47
	@echo
48
	@echo "Build finished. The HTML pages are in build/html."
49

  
50
dirhtml:
51
	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) build/dirhtml
52
	@echo
53
	@echo "Build finished. The HTML pages are in build/dirhtml."
54

  
55
pickle:
56
	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) build/pickle
57
	@echo
58
	@echo "Build finished; now you can process the pickle files."
59

  
60
json:
61
	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) build/json
62
	@echo
63
	@echo "Build finished; now you can process the JSON files."
64

  
65
htmlhelp:
66
	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) build/htmlhelp
67
	@echo
68
	@echo "Build finished; now you can run HTML Help Workshop with the" \
69
	      ".hhp project file in build/htmlhelp."
70

  
71
qthelp:
72
	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) build/qthelp
73
	@echo
74
	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
75
	      ".qhcp project file in build/qthelp, like this:"
76
	@echo "# qcollectiongenerator build/qthelp/test.qhcp"
77
	@echo "To view the help file:"
78
	@echo "# assistant -collectionFile build/qthelp/test.qhc"
79

  
80
epub:
81
	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) build/epub
82
	@echo
83
	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
84

  
85

  
86
latex:
87
	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) build/latex
88
	@echo
89
	@echo "Build finished; the LaTeX files are in build/latex."
90
	@echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \
91
	      "run these through (pdf)latex."
92

  
93
changes:
94
	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) build/changes
95
	@echo
96
	@echo "The overview file is in build/changes."
97

  
98
linkcheck:
99
	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) build/linkcheck
100
	@echo
101
	@echo "Link check complete; look for any errors in the above output " \
102
	      "or in build/linkcheck/output.txt."
103

  
104
doctest:
105
	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) build/doctest
106
	@echo "Testing of doctests in the sources finished, look at the " \
107
	      "results in build/doctest/output.txt."
108

  
109
latexpdf: latex
110
	@echo "Running LaTeX files through latexmk..."
111
	$(MAKE) -C build/latex all-pdf
112
	@echo "latexmk finished; the PDF files are in build/latex."
113

  
114
docs: clean html latexpdf
115
	cp build/latex/networkx_reference.pdf build/html/_downloads/.
116
	
117
gitwash-update:
118
	python ../tools/gitwash_dumper.py developer networkx \
119
	--project-url=http://networkx.github.io \
120
	--project-ml-url=http://groups.google.com/group/networkx-discuss/ \
121
	--gitwash-url git@github.com:matthew-brett/gitwash.git
networkxMiCe/networkx-master/doc/README.md
1
# Building docs
2

  
3
We currently use Sphinx for generating the API and reference
4
documentation for NetworkX.
5

  
6
If you only want to get the documentation, note that pre-built
7
versions can be found at
8

  
9
    http://networkx.github.io/
10

  
11
for both the stable and the latest (i.e., development) releases.
12

  
13
## Instructions
14

  
15
In addition to installing NetworkX and its dependencies, install the Python
16
packages need to build the documentation by entering::
17

  
18
    pip install -r requirements.txt
19

  
20
in the ``doc/`` directory.
21

  
22
To build the HTML documentation, enter::
23

  
24
    make html
25

  
26
in the ``doc/`` directory. If all goes well, this will generate a
27
``build/html`` subdirectory containing the built documentation.
28

  
29
To build the PDF documentation, enter::
30

  
31
    make latexpdf
32

  
33
You will need to have Latex installed for this.
networkxMiCe/networkx-master/doc/_static/copybutton.js
1
/* This script from Doc/tools/static/copybutton.js in CPython distribution */
2
$(document).ready(function() {
3
    /* Add a [>>>] button on the top-right corner of code samples to hide
4
     * the >>> and ... prompts and the output and thus make the code
5
     * copyable. */
6
    var div = $('.highlight-python .highlight,' +
7
                '.highlight-default .highlight')
8
    var pre = div.find('pre');
9

  
10
    // get the styles from the current theme
11
    pre.parent().parent().css('position', 'relative');
12
    var hide_text = 'Hide the prompts and output';
13
    var show_text = 'Show the prompts and output';
14
    var border_width = pre.css('border-top-width');
15
    var border_style = pre.css('border-top-style');
16
    var border_color = pre.css('border-top-color');
17
    var button_styles = {
18
        'cursor':'pointer', 'position': 'absolute', 'top': '0', 'right': '0',
19
        'border-color': border_color, 'border-style': border_style,
20
        'border-width': border_width, 'color': border_color, 'text-size': '75%',
21
        'font-family': 'monospace', 'padding-left': '0.2em', 'padding-right': '0.2em',
22
        'border-radius': '0 3px 0 0'
23
    }
24

  
25
    // create and add the button to all the code blocks that contain >>>
26
    div.each(function(index) {
27
        var jthis = $(this);
28
        if (jthis.find('.gp').length > 0) {
29
            var button = $('<span class="copybutton">&gt;&gt;&gt;</span>');
30
            button.css(button_styles)
31
            button.attr('title', hide_text);
32
            button.data('hidden', 'false');
33
            jthis.prepend(button);
34
        }
35
        // tracebacks (.gt) contain bare text elements that need to be
36
        // wrapped in a span to work with .nextUntil() (see later)
37
        jthis.find('pre:has(.gt)').contents().filter(function() {
38
            return ((this.nodeType == 3) && (this.data.trim().length > 0));
39
        }).wrap('<span>');
40
    });
41

  
42
    // define the behavior of the button when it's clicked
43
    $('.copybutton').click(function(e){
44
        e.preventDefault();
45
        var button = $(this);
46
        if (button.data('hidden') === 'false') {
47
            // hide the code output
48
            button.parent().find('.go, .gp, .gt').hide();
49
            button.next('pre').find('.gt').nextUntil('.gp, .go').css('visibility', 'hidden');
50
            button.css('text-decoration', 'line-through');
51
            button.attr('title', show_text);
52
            button.data('hidden', 'true');
53
        } else {
54
            // show the code output
55
            button.parent().find('.go, .gp, .gt').show();
56
            button.next('pre').find('.gt').nextUntil('.gp, .go').css('visibility', 'visible');
57
            button.css('text-decoration', 'none');
58
            button.attr('title', hide_text);
59
            button.data('hidden', 'false');
60
        }
61
    });
62
});
networkxMiCe/networkx-master/doc/bibliography.rst
1
..  -*- coding: utf-8 -*-
2

  
3
Bibliography
4
============
5

  
6
.. [BA02] R. Albert and A.-L. Barabási, "Statistical mechanics of complex
7
   networks", Reviews of Modern Physics, 74, pp. 47-97, 2002. 
8
   https://arxiv.org/abs/cond-mat/0106096
9

  
10
.. [Bollobas01] B. Bollobás, "Random Graphs", Second Edition,
11
   Cambridge University Press, 2001.
12

  
13
.. [BE05] U. Brandes and T. Erlebach, "Network Analysis:
14
   Methodological Foundations", Lecture Notes in Computer Science, 
15
   Volume 3418, Springer-Verlag, 2005.
16

  
17
.. [CL1996] G. Chartrand and L. Lesniak, "Graphs and Digraphs", 
18
   Chapman and Hall/CRC, 1996.
19

  
20
.. [choudum1986] S.A. Choudum. "A simple proof of the Erdős-Gallai theorem on 
21
   graph sequences." Bulletin of the Australian Mathematical Society, 33, 
22
   pp 67-70, 1986. https://doi.org/10.1017/S0004972700002872
23

  
24
.. [Diestel97] R. Diestel, "Graph Theory", Springer-Verlag, 1997. 
25
   http://diestel-graph-theory.com/index.html
26

  
27
.. [DM03] S.N. Dorogovtsev and J.F.F. Mendes, "Evolution of Networks",
28
   Oxford University Press, 2003.
29

  
30
.. [EppsteinPads] David Eppstein.
31
   PADS, A library of Python Algorithms and Data Structures.
32
   http://www.ics.uci.edu/~eppstein/PADS
33
   
34
.. [EG1960] Erdős and Gallai, Mat. Lapok 11 264, 1960.
35

  
36
.. [hakimi1962] Hakimi, S. "On the Realizability of a Set of Integers as 
37
   Degrees of the Vertices of a Graph." SIAM J. Appl. Math. 10, 496-506, 1962.
38

  
39
.. [havel1955] Havel, V. "A Remark on the Existence of Finite Graphs" 
40
   Casopis Pest. Mat. 80, 477-480, 1955.
41
   
42
.. [Langtangen04] H.P. Langtangen, "Python Scripting for Computational
43
    Science.", Springer Verlag Series in Computational Science and
44
    Engineering, 2004. 
45

  
46
.. [Martelli03]  A. Martelli, "Python in a Nutshell", O'Reilly Media
47
   Inc, 2003.
48

  
49
.. [Newman03] M.E.J. Newman, "The Structure and Function of Complex
50
   Networks", SIAM Review, 45, pp. 167-256, 2003. 
51
   http://epubs.siam.org/doi/abs/10.1137/S003614450342480
52

  
53
.. [Sedgewick02] R. Sedgewick, "Algorithms in C: Parts 1-4: 
54
   Fundamentals, Data Structure, Sorting, Searching", Addison Wesley
55
   Professional, 3rd ed., 2002.
56

  
57
.. [Sedgewick01] R. Sedgewick, "Algorithms in C, Part 5: Graph Algorithms",
58
   Addison Wesley Professional, 3rd ed., 2001.
59

  
60
.. [West01] D. B. West, "Introduction to Graph Theory", Prentice Hall,
61
    2nd ed., 2001.
62

  
63
.. [vanRossum98] Guido van Rossum. Python Patterns - Implementing Graphs, 1998.
64
   https://www.python.org/doc/essays/graphs
65

  
networkxMiCe/networkx-master/doc/citing.rst
1
.. -*- coding: utf-8 -*-
2

  
3
Citing
4
======
5

  
6
To cite NetworkX please use the following publication:
7

  
8
Aric A. Hagberg, Daniel A. Schult and Pieter J. Swart, 
9
`"Exploring network structure, dynamics, and function using NetworkX"
10
<http://conference.scipy.org/proceedings/SciPy2008/paper_2/>`_,
11
in
12
`Proceedings of the 7th Python in Science Conference (SciPy2008)
13
<http://conference.scipy.org/proceedings/SciPy2008/index.html>`_, Gäel
14
Varoquaux, Travis Vaught, and Jarrod Millman (Eds), (Pasadena, CA
15
USA), pp. 11--15, Aug 2008
16

  
17
.. only:: html
18

  
19
   `PDF <http://math.lanl.gov/~hagberg/Papers/hagberg-2008-exploring.pdf>`_
20
   `BibTeX <http://math.lanl.gov/~hagberg/Publications/hagberg-2008-exploring.shtml>`_
networkxMiCe/networkx-master/doc/conf.py
1
# -*- coding: utf-8 -*-
2
#
3
# Sphinx documentation build configuration file, created by
4
# sphinx-quickstart.py on Sat Mar  8 21:47:50 2008.
5
#
6
# This file is execfile()d with the current directory set to its containing dir.
7
#
8
# The contents of this file are pickled, so don't put values in the namespace
9
# that aren't pickleable (module imports are okay, they're removed automatically).
10
#
11
# All configuration values have a default value; values that are commented out
12
# serve to show the default value.
13
from __future__ import print_function
14

  
15
import sys
16
import os
17
from datetime import date
18

  
19
from sphinx_gallery.sorting import ExplicitOrder
20

  
21
# Check Sphinx version
22
import sphinx
23
if sphinx.__version__ < "1.3":
24
    raise RuntimeError("Sphinx 1.3 or newer required")
25

  
26
# Environment variable to know if the docs are being built on rtd.
27
on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
28
#print
29
#print("Building on ReadTheDocs: {}".format(on_rtd))
30
#print
31
#print("Current working directory: {}".format(os.path.abspath(os.curdir)))
32
#print("Python: {}".format(sys.executable))
33

  
34
# If your extensions are in another directory, add it here.
35
# These locations are relative to conf.py
36

  
37
# General configuration
38
# ---------------------
39

  
40
# Add any Sphinx extension module names here, as strings. They can be extensions
41
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
42
extensions = [
43
    'sphinx.ext.autosummary',
44
    'sphinx.ext.autodoc',
45
    'sphinx.ext.coverage',
46
    'sphinx.ext.doctest',
47
    'sphinx.ext.intersphinx',
48
    'sphinx.ext.mathjax',
49
    'sphinx.ext.napoleon',
50
    'sphinx.ext.todo',
51
    'sphinx.ext.viewcode',
52
    'sphinx_gallery.gen_gallery',
53
    'nb2plots',
54
    'texext',
55
]
56

  
57
# https://github.com/sphinx-gallery/sphinx-gallery
58
sphinx_gallery_conf = {
59
    # path to your examples scripts
60
    'examples_dirs': '../examples',
61
    'subsection_order': ExplicitOrder(['../examples/basic',
62
                                       '../examples/drawing',
63
                                       '../examples/graph',
64
                                       '../examples/algorithms',
65
                                       '../examples/advanced',
66
                                       '../examples/3d_drawing',
67
                                       '../examples/pygraphviz',
68
                                       '../examples/javascript',
69
                                       '../examples/jit',
70
                                       '../examples/applications',
71
                                       '../examples/subclass']),
72
    # path where to save gallery generated examples
73
    'gallery_dirs': 'auto_examples',
74
    'backreferences_dir': 'modules/generated',
75
    'expected_failing_examples': ['../examples/advanced/plot_parallel_betweenness.py']
76
}
77

  
78
# generate autosummary pages
79
autosummary_generate = True
80

  
81
# Add any paths that contain templates here, relative to this directory.
82
#templates_path = ['']
83

  
84
suppress_warnings = ['ref.citation', 'ref.footnote']
85

  
86
# The suffix of source filenames.
87
source_suffix = '.rst'
88

  
89
# The encoding of source files.
90
source_encoding = 'utf-8'
91

  
92
# The master toctree document.
93
master_doc = 'index'
94

  
95
# General substitutions.
96
project = 'NetworkX'
... This diff was truncated because it exceeds the maximum size that can be displayed.

Also available in: Unified diff