added napoleon to sphinx conf

.gitlab-ci.yml

+pages:
+  image: alpine
+  stage: deploy
+  script:
+  - apk --no-cache add py2-pip python-dev
+  - pip install sphinx
+  - apk --no-cache add make
+  - cd doc
+  - make html
+  - mv build/html/ ../public
+  artifacts:
+    paths:
+    - public
+  only:
+  - master

impute_jass/doc/source/conf.py

@@ -41,6 +41,7 @@ release = '1.0'
 # ones.
 extensions = [
     'sphinx.ext.autodoc',
+    'sphinx.ext.napoleon',
     'sphinx.ext.coverage',
     'sphinx.ext.mathjax',
     'sphinx.ext.viewcode',

impute_jass/impute_jass/imputation_launcher.py

-"""
+# -*- coding: utf-8 -*-
+"""Imputation launcher
+
 Function set to launch SNP imputation on a complete chromosome or
 on the genome
+
 """
+
 import glob
 import pandas as pd
-from .windows import ld_region_centered_window_imputation, prepare_zscore_for_imputation, impg_like_imputation, realigned_zfiles_on_panel
-
+from .windows import prepare_zscore_for_imputation, impg_like_imputation, realigned_zfiles_on_panel
 
 class ImputationLauncher(object):
     """

impute_jass/impute_jass/stat_models.py

@@ -10,8 +10,6 @@ Fast and accurate imputation of summary statistics enhances evidence
 of functional enrichment, Bioinformatics, Volume 30, Issue 20, 15 October 2014,
 Pages 2906–2914
 
-Todo:
-* add better docstring
 
 """
 import numpy as np
@@ -21,7 +19,7 @@ import scipy.linalg
 def compute_mu(sig_i_t, sig_t_inv, zt):
     """
     Compute the estimation of z-score from neighborring snp
-    
+
     Args:
         sig_i_t (matrix?) : correlation matrix with line corresponding to
         unknown Snp (snp to impute) and column to known SNPs