Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

improve documentation #167

Merged
merged 80 commits into from
Feb 8, 2021
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
80 commits
Select commit Hold shift + click to select a range
8070fe6
sort imports
sampan501 Jan 13, 2021
c0ac9e7
Merge branch 'master' into energy-mmd-disco
sampan501 Jan 13, 2021
ddfe3b0
fix docs error short underline
sampan501 Jan 13, 2021
65a2569
add energy source code
sampan501 Jan 13, 2021
05c8165
fix tutorials not rendering
sampan501 Jan 13, 2021
95b0a31
add more detail to compute distance and kernel
sampan501 Jan 13, 2021
1884dd2
Merge branch 'master' into better-docs
sampan501 Jan 13, 2021
c6916b9
add tutorials folder with overview
sampan501 Jan 14, 2021
5c83c70
add folder to gitignore
sampan501 Jan 15, 2021
07f55e2
add contributing guidelines to github repo
sampan501 Jan 15, 2021
fff2b0d
make docs look nicer
sampan501 Jan 15, 2021
a7d77fc
change reference to use automodule
sampan501 Jan 15, 2021
8484dbb
add changelog to single file
sampan501 Jan 15, 2021
e5a0402
remove reference folder
sampan501 Jan 15, 2021
760f10d
make clear the package reqs needs to be installed
sampan501 Jan 15, 2021
e4a5911
simplify autosummary table
sampan501 Jan 15, 2021
e44e1d4
remove old changelog files
sampan501 Jan 15, 2021
09e97f7
add file with all automodules
sampan501 Jan 15, 2021
3efedac
change docs layout
sampan501 Jan 15, 2021
7d4f7c0
add gallery and misc docs changes
sampan501 Jan 15, 2021
a996e77
change order of sidebar
sampan501 Jan 15, 2021
7c3bf1b
make install docs more clear
sampan501 Jan 15, 2021
5f8938c
update makefile with autogen and more options
sampan501 Jan 15, 2021
41a224f
update docs package requirements
sampan501 Jan 15, 2021
98cd501
remove github_links file
sampan501 Jan 15, 2021
8ce777e
remove old tutorial folder
sampan501 Jan 15, 2021
65dab0e
remove tutorials and gallery folders from docs
sampan501 Jan 15, 2021
7b1c6d7
add discriminability
sampan501 Jan 18, 2021
02bdeae
add statistic to the docs
sampan501 Jan 18, 2021
f902282
fix dcorr and hsic incorrect stats
sampan501 Jan 18, 2021
d439f6a
Merge branch 'master' into better-docs
sampan501 Jan 19, 2021
92e70c2
Merge branch 'master' into better-docs
sampan501 Jan 20, 2021
e64dae0
add citation page
sampan501 Jan 22, 2021
5f7b144
add internal links within docs
sampan501 Jan 22, 2021
4e68424
use readme in index.rst
sampan501 Jan 22, 2021
4e5d0d9
add links for dependencies
sampan501 Jan 22, 2021
a54fa40
use meth and class
sampan501 Jan 22, 2021
9a17205
update doc requirements
sampan501 Jan 22, 2021
615ec9d
remove docs tutorial page
sampan501 Jan 22, 2021
c85a5fa
update README to rst
sampan501 Jan 22, 2021
b61eb57
Update setup.py
sampan501 Jan 22, 2021
fe8cd2e
fix reference docs formatting
sampan501 Jan 22, 2021
f4b2844
remove figure from package overview
sampan501 Jan 22, 2021
a38fb43
add example folder
sampan501 Jan 22, 2021
45f27a4
add mgc map example
sampan501 Jan 22, 2021
2f83436
add independence simulations example
sampan501 Jan 22, 2021
a0d2412
add feature importance example
sampan501 Jan 22, 2021
572a640
install package pip netlify
sampan501 Jan 26, 2021
0f52c9a
Update netlify.toml
sampan501 Jan 26, 2021
81a58f9
add recommonmark
sampan501 Jan 26, 2021
34452d1
add matplotlib and seaborn
sampan501 Jan 26, 2021
550bf31
add tutorials and mmd
sampan501 Jan 26, 2021
b935187
add disco
sampan501 Jan 26, 2021
00de4f9
update doctest errors
sampan501 Jan 26, 2021
51c1dc8
Update mmd.py
sampan501 Jan 26, 2021
9c1e2ff
fix intersphinx mapping
sampan501 Jan 28, 2021
6b1bf60
move gaussian sim to new example
sampan501 Jan 28, 2021
8d9d0da
remove reps warning
sampan501 Feb 2, 2021
7a17b8e
add fast 1D Dcorr
sampan501 Feb 2, 2021
17225a9
add helper functions reference
sampan501 Feb 2, 2021
9b424cc
add manova and hotelling
sampan501 Feb 7, 2021
42007a2
fix documentation weird renderings
sampan501 Feb 7, 2021
fbbfb24
remove unused import indep_sims
sampan501 Feb 7, 2021
8f9db33
add max margin test
sampan501 Feb 8, 2021
f181538
fix doctest assertion errors
sampan501 Feb 8, 2021
1c657a8
cache numba
sampan501 Feb 8, 2021
6311eb0
add k-sample tutorial
sampan501 Feb 8, 2021
de0ddac
move general example to overview py file
sampan501 Feb 8, 2021
9a6e880
add time-series tutorial
sampan501 Feb 8, 2021
605ea9c
add time series tutorial
sampan501 Feb 8, 2021
5b0d7c9
add time series sims
sampan501 Feb 8, 2021
ec22b5c
fix tutorials
sampan501 Feb 8, 2021
db9b3e6
add v to tag name
sampan501 Feb 8, 2021
da680ec
change order of independence test
sampan501 Feb 8, 2021
f25bb81
add discriminability tutorial
sampan501 Feb 8, 2021
597b6c5
change name of time series sim file
sampan501 Feb 8, 2021
e936ea7
[skip ci] clean netlify directory
sampan501 Feb 8, 2021
7dd860d
[skip ci] rebuild docs
sampan501 Feb 8, 2021
eac3255
[skip ci] update netlify runtime version
sampan501 Feb 8, 2021
66ef343
change netlify build command to fix intersphinx
sampan501 Feb 8, 2021
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
update README to rst
  • Loading branch information
sampan501 committed Jan 22, 2021
commit c85a5faed5934ad81b31e5ffcb8514dd4b7a0ee9
71 changes: 0 additions & 71 deletions README.md

This file was deleted.

93 changes: 93 additions & 0 deletions README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
.. -*- mode: rst -*-

hyppo
******

|CircleCI|_ |Codecov|_ |Netlify|_ |PythonVersion|_ |PyPi|_ |arXivshield|_

.. |CircleCI| image:: https://circleci.com/gh/neurodata/hyppo/tree/master.svg?style=shield&circle-token=:circle-token
.. _CircleCI: https://circleci.com/gh/neurodata/hyppo

.. |Codecov| image:: hhttps://codecov.io/gh/neurodata/hyppo/branch/master/graph/badge.svg?token=a2TXyRVW0a
.. _Codecov: https://codecov.io/gh/neurodata/hyppo

.. |Netlify| image:: https://img.shields.io/netlify/e5242ebd-631e-4330-b43e-85e428dac66a
.. _`Netlify`: https://app.netlify.com/sites/hyppo/deploys

.. |PythonVersion| image:: https://img.shields.io/badge/python-3.6%20%7C%203.7%20%7C%203.8-blue
.. _PythonVersion: https://img.shields.io/badge/python-3.6%20%7C%203.7%20%7C%203.8-blue

.. |PyPi| image:: https://badge.fury.io/py/hyppo.svg
.. _PyPi: https://pypi.org/project/hyppo/

.. |arXivshield| image:: https://img.shields.io/badge/arXiv-1907.02088-red.svg?style=flat
.. _arXivshield: https://arxiv.org/abs/1907.02088

.. placeholder-for-doc-index

hyppo (\ **HYP**\ othesis Testing in **P**\ yth\ **O**\ n, pronounced "Hippo") is an open-source software package for multivariate hypothesis testing. We decided to develop hyppo for the following reasons:

* With the increase in the amount of data in many fields, hypothesis testing for high dimensional and nonlinear data is important
* Libraries in R exist, but their interfaces are inconsistent and most are not available in Python

hyppo intends to be a comprehensive multivariate hypothesis testing package and runs on all major versions of operating systems. It also includes novel tests not found in other packages. It is quick to install and free of charge. If you need to use multivariate hypothesis testing, be sure to give hyppo a try!

Website: https://hyppo.neurodata.io/

Installation
------------

Dependencies
=============

hyppo requires the following:

- `python <https://www.python.org/>`_ (>= 3.6)
- `numba <https://numba.pydata.org/>`_ (>= 0.46)
- `numpy <https://numpy.org/>`_ (>= 1.17)
- `scipy <https://docs.scipy.org/doc/scipy/reference/>`_ (>= 1.4.0)
- `scikit-learn <https://scikit-learn.org/stable/>`_ (>= 0.22)
- `joblib <https://joblib.readthedocs.io/en/latest/>`_ (>= 0.17.0)

User installation
==================

The easiest way to install hyppo is using ``pip``::

pip install hyppo

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

pip install --upgrade hyppo

The documentation includes more detailed `installation instructions <https://hyppo.neurodata.io/install.html>`_.
hyppo is free software; you can redistribute it and/or modify it under the
terms of the `license <https://hyppo.neurodata.io/license.html>`_.

Changelog
----------

See the `changelog <https://hyppo.neurodata.io/news.html>`_
for a history of notable changes to hyppo.

Development
------------

We welcome new contributors of all experience levels. The hyppo
community goals are to be helpful, welcoming, and effective. The
`contributor guide <https://hyppo.neurodata.io/contributing.html>`_
has detailed information about contributing code, documentation and tests.

- Official source code: https://github.com/neurodata/hyppo/tree/master/hyppo
- Download releases: https://pypi.org/project/hyppo/
- Issue tracker: https://github.com/neurodata/hyppo/issues

**Note: We have recently moved our** ``benchmarks`` **(with relevant figure replication code for our papers) folder to a new** `repo <https://github.com/neurodata/hyppo-papers>`_\ **!** We aim to add test development code and paper figure replication code there, and will add relevant tests (with tutorials) to hyppo.

Project History
----------------

hyppo is a rebranding of mgcpy, which was founded in Novemember 2018.
mgcpy was designed and written by Satish Palaniappan, Sambit
Panda, Junhao Xiong, Sandhya Ramachandran, and Ronak Mehtra. hyppo
was designed and written by Sambit Panda and first released February 2020.