Merge pull request #20 from fdtomasi/develop

Code refactoring and docstring

.gitignore

@@ -1,3 +1,4 @@
+notebooks/Untitled Folder/
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]
@@ -104,3 +105,11 @@ ENV/
 .magicindex.json
 
 \.vscode/
+
+/*/**/\.DS_Store
+
+\.DS_Store
+
+notebooks/graph-clustering/temp-plot\.html
+
+notebooks/octave-workspace

.travis.yml

@@ -10,6 +10,7 @@ branches:
   - experimental
   - develop
   - tensorflow
+  - features/*
 
 cache: pip
 before_install:
@@ -29,34 +30,34 @@ script:
 after_success:
 - codecov
 deploy:
-  - provider: pypi
-    user: fdtomasi
+- provider: pypi
+  user: fdtomasi
+  password:
+    secure: Wvo0RfNjtW3CikjE0gVNkP2gH1mf8qrh/5TCkxrAlqUVN0GnRV76JwKE8C55AH0OrpKBSdWEKb54K1OwtwtWlHojrWdKaJG7R3ASprOv6nVn0sBgSH7qmI6DWnKEQlCb0slr3RP2dOdMSuz3rr0rjEppwViSNvLbigZz6IltiG6uDHnMxgfgTWTGV4uamnOQuuZ6PktRzqOW3Rqp4HQNP2+nIvuPwfe06hll45mGHhzyTJC/rSJmV0/bAfr1mo6cFSO7VD/Lmo1Opu1tTl/8FkGVUbCZtTyCasf/F5IB1v8yNy+Tb2HtnOxR6NbnjJkT/vuftOrMFxQPd8ZWVbbeMO3RRlDUR2al5mNK4nI38efgS54ZZIzkx3ek4duAeCm5fwi/FrL+hndtiiT0DNHbQ2QA+b7o/4Ag9kJgcI5M0jYO7rPPg1sgm4nQ4QEugfR0vY5/pSLQSRZ2EY7AKyJsgPc7pkl/t310v0HtEsbmEzEgwOw0SIcc0+bUou53R9E5h1M1xKcLVV9jqyjTs+GahcRd54xMRGsYpDn+9u7i07kj2GqrYjubzvZeL2QSrPMBtujeeKLMQMWAQZ/TmIyLD0f+zh0xpAUb0EYVIEml3a5p2q/kavPVZJAY202Wa7SbJGDVt+02+dgsUJg0nAEvO3xu9JOyY12WkR6QNnQC0Qk=
+  distributions: sdist bdist_wheel
+  on:
+    repo: fdtomasi/regain
+    tags: true
+    python: '2.7'
+- provider: releases
+  api_key:
+    secure: IbzvHgN5aRUwSUcTdnnmLqAJw1DZz2InulgYheAT1CrUwepXWguppdD4zYnkhylZ283rNPHgeuyfIBl/x1SXQHqkyOXb5TjjhMU7t2iMM1M5NzZ8p5VsYcV8er3HkDj2br7/kgW0UdyHBaGHwgyLNULTBehCnK5zagvuY0A5M5vjljuJ7DPi/v/UtorBBqpY6/tJ7se+/Qy4XVrRyAxTkq+Nr3bTb742dERZLHyIDiv/kYEYQaMsHC/t4lPTTuZZsz1rs8C9/hi1+C8Dsjmo/nks46m2mmAaYwEGvM3bzBEFyF2o+IDrnV7JE0JhJHzEIEotKmVxG1AVntlbSyLyirZh6qqfLnLSqTYMynRlggNEhT4meOifc1g3f9KtZQtfO6y90ffhEVNpwVOGg7CVIiH1p4DiS01byT9H7bPH2LJyla3P6WG6gJx4jdEYcfv28NK0K7kk90vICKySv0LsCm/9iZlGcHSbd9O55U7sG8oQcXJdJfXYYqml2SBtOjjprI9mwdmvvsInAp3EkAi31+y8IMMPNba6/iv96WF3ZW2nez6l13kbZmC8tBl63TJb7gHYxHGER3T97VeYA7XmHd+va9qtfQ7/lngwJHJgFXm3C5h0QiK4guWGqqwDboluSOgz8zpxrhrzhtd3R/0zA7nASyKfnq+FdOV38Duxkrc=
+  skip_cleanup: true
+  on:
+    repo: fdtomasi/regain
+    tags: true
+- provider: script
+  script: bash deploy_anaconda.sh
+  skip_cleanup: true
+  on:
+    repo: fdtomasi/regain
+    tags: true
     password:
       secure: Wvo0RfNjtW3CikjE0gVNkP2gH1mf8qrh/5TCkxrAlqUVN0GnRV76JwKE8C55AH0OrpKBSdWEKb54K1OwtwtWlHojrWdKaJG7R3ASprOv6nVn0sBgSH7qmI6DWnKEQlCb0slr3RP2dOdMSuz3rr0rjEppwViSNvLbigZz6IltiG6uDHnMxgfgTWTGV4uamnOQuuZ6PktRzqOW3Rqp4HQNP2+nIvuPwfe06hll45mGHhzyTJC/rSJmV0/bAfr1mo6cFSO7VD/Lmo1Opu1tTl/8FkGVUbCZtTyCasf/F5IB1v8yNy+Tb2HtnOxR6NbnjJkT/vuftOrMFxQPd8ZWVbbeMO3RRlDUR2al5mNK4nI38efgS54ZZIzkx3ek4duAeCm5fwi/FrL+hndtiiT0DNHbQ2QA+b7o/4Ag9kJgcI5M0jYO7rPPg1sgm4nQ4QEugfR0vY5/pSLQSRZ2EY7AKyJsgPc7pkl/t310v0HtEsbmEzEgwOw0SIcc0+bUou53R9E5h1M1xKcLVV9jqyjTs+GahcRd54xMRGsYpDn+9u7i07kj2GqrYjubzvZeL2QSrPMBtujeeKLMQMWAQZ/TmIyLD0f+zh0xpAUb0EYVIEml3a5p2q/kavPVZJAY202Wa7SbJGDVt+02+dgsUJg0nAEvO3xu9JOyY12WkR6QNnQC0Qk=
-    distributions: sdist bdist_wheel
-    on:
-      repo: fdtomasi/regain
-      tags: true
-      python: '2.7'
-  - provider: releases
-    api_key:
-      secure: IbzvHgN5aRUwSUcTdnnmLqAJw1DZz2InulgYheAT1CrUwepXWguppdD4zYnkhylZ283rNPHgeuyfIBl/x1SXQHqkyOXb5TjjhMU7t2iMM1M5NzZ8p5VsYcV8er3HkDj2br7/kgW0UdyHBaGHwgyLNULTBehCnK5zagvuY0A5M5vjljuJ7DPi/v/UtorBBqpY6/tJ7se+/Qy4XVrRyAxTkq+Nr3bTb742dERZLHyIDiv/kYEYQaMsHC/t4lPTTuZZsz1rs8C9/hi1+C8Dsjmo/nks46m2mmAaYwEGvM3bzBEFyF2o+IDrnV7JE0JhJHzEIEotKmVxG1AVntlbSyLyirZh6qqfLnLSqTYMynRlggNEhT4meOifc1g3f9KtZQtfO6y90ffhEVNpwVOGg7CVIiH1p4DiS01byT9H7bPH2LJyla3P6WG6gJx4jdEYcfv28NK0K7kk90vICKySv0LsCm/9iZlGcHSbd9O55U7sG8oQcXJdJfXYYqml2SBtOjjprI9mwdmvvsInAp3EkAi31+y8IMMPNba6/iv96WF3ZW2nez6l13kbZmC8tBl63TJb7gHYxHGER3T97VeYA7XmHd+va9qtfQ7/lngwJHJgFXm3C5h0QiK4guWGqqwDboluSOgz8zpxrhrzhtd3R/0zA7nASyKfnq+FdOV38Duxkrc=
-    skip_cleanup: true
-    on:
-      repo: fdtomasi/regain
-      tags: true
-  - provider: script
-    script: bash deploy_anaconda.sh
-    skip_cleanup: true
-    on:
-      repo: fdtomasi/regain
-      tags: true
-      password:
-        secure: Wvo0RfNjtW3CikjE0gVNkP2gH1mf8qrh/5TCkxrAlqUVN0GnRV76JwKE8C55AH0OrpKBSdWEKb54K1OwtwtWlHojrWdKaJG7R3ASprOv6nVn0sBgSH7qmI6DWnKEQlCb0slr3RP2dOdMSuz3rr0rjEppwViSNvLbigZz6IltiG6uDHnMxgfgTWTGV4uamnOQuuZ6PktRzqOW3Rqp4HQNP2+nIvuPwfe06hll45mGHhzyTJC/rSJmV0/bAfr1mo6cFSO7VD/Lmo1Opu1tTl/8FkGVUbCZtTyCasf/F5IB1v8yNy+Tb2HtnOxR6NbnjJkT/vuftOrMFxQPd8ZWVbbeMO3RRlDUR2al5mNK4nI38efgS54ZZIzkx3ek4duAeCm5fwi/FrL+hndtiiT0DNHbQ2QA+b7o/4Ag9kJgcI5M0jYO7rPPg1sgm4nQ4QEugfR0vY5/pSLQSRZ2EY7AKyJsgPc7pkl/t310v0HtEsbmEzEgwOw0SIcc0+bUou53R9E5h1M1xKcLVV9jqyjTs+GahcRd54xMRGsYpDn+9u7i07kj2GqrYjubzvZeL2QSrPMBtujeeKLMQMWAQZ/TmIyLD0f+zh0xpAUb0EYVIEml3a5p2q/kavPVZJAY202Wa7SbJGDVt+02+dgsUJg0nAEvO3xu9JOyY12WkR6QNnQC0Qk=
 notifications:
   slack:
     rooms:
-    - secure: I+CJQ9xJ7wXcVfJ33pWpWS16zhRDD1odSpCKINQMpTV9UEtCo7n9SmOwaKD/JRDkyW2eT2VwK5d86gzgEEDAiPk3+Kysx6nokp9tg22t0vZ6bdFHj/9N7Vqu3THZ0xWGik/WMdOh6bdM4TK2sJPiqX8L7GKFVDqBeNF5nL3qTHhAjpIl6juXlY8A2CNAtdsdzX0pGa4Q+1LIATs6ViXac6jaW4JLdOt2hXIrKR1S43gVIs3s2N9QZ06s0LXMux68bEQiW6/BHhs6FlAUmGv2KhmMhP4gZnKkcnw/B0sq8l/35S/A10vHZG9JuQzjzvOKBn1JMNt/LtiEca4CcxVwamWHFUvEPAkI0LHzv09DCFGgnu/o1ClAx3IMPik6kkDFHfqRemUsv3tJu+PMZfsOLmSK5e+TT5uTljPZq0MxTVun53JAx6ziBkuiI+gMT9j6wYXZ41P+rf5tTcUG6uhlfCqjypMPjTHK4wy6zGgPS1RelPMblLlFfpMgqDe/pL7iVkamxxURqtbchYDzF10FCY1p+xXOLyq9hXBAHaSEGKYWjjdRzI+s19YX8Ln25ytEFObKzgPp/tXu4sqR/DmBhb7t9CM7unpKf35kmTv6EJi6qCvSfi1Ncj/sOpaIJhKGD4OxnAjm8FARGM/sPDoZWJOk3m2n9bW+qKpmSe6BuDI=
+    - secure: rvkrsS1FnFitYBMuc6Y6a6gpN1z+YwFx83M9vsgVFfrng5KS91/veknffWdOF3cVxdZrnB3/xwL8sIr0tsfuKrTs3mVizshhC3KQD3PaE6mgtZ+Ehi2NAYqDNUmU5FHfD6hkIKevrUIuyC5I8qr6dSM6G7gpsaeCfbeM84JK7YTyXsKqTu9vu6rnZU9bQDjD9qAtjVtCaMa1F4edfMittY/QOuPGMXd0KMZAg9qsRvvfT6xKioVwOB0hdCERE5cbR4qrn6j98HHtAGK3z5JVctUHKgST4DWKo8yXJNGv0JSVEaUP0EG1dZ/xst+++8On+SNWKng21c1baXVZJV32mW22zaNRoczvlXVpn5UACHOrZZLQia1HfJf0Lsiiu7192CeDhtgwtOrO5tw94p69l1qLmKjvyqX1owCC6FAXFLG8+/0RvZgir80rMxkty4TlRQCs7M71ZS97CQcOZK6bpiQfFtfltVJFGnsd5As7OMTnleRc2iSnKOu7YJQ6DhjZkFMboJRvvfmHjYYdPdVFrLVMh3A+DriQRHbFb48RtiAZD02kOQtAFn+1niFBye3A8cFdWw5fSWy9HsMCrDtxOPYfduYMY/pdeZd2u2D9gaJm6wCYpa9Tb/WfkvXeamChsoHTGAEUraFnqQ9dTJe1oqyX35HONHqIIVyGCT3X7W4=
     on_success: change
     on_failure: always
   email: false

LICENSE

@@ -1,6 +1,6 @@
 BSD 3-Clause License
 
-Copyright (c) 2017, Federico T.
+Copyright (c) 2019, regain authors
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without