From 864f821831446c7943b087c2cdf872e5f8629db4 Mon Sep 17 00:00:00 2001
From: hjulienne <hanna.julienne@gmail.com>
Date: Tue, 27 Nov 2018 11:50:02 +0000
Subject: [PATCH] enhance documentation

---
 doc/_build/doctrees/environment.pickle | Bin 36632 -> 39457 bytes
 doc/_build/doctrees/index.doctree      | Bin 30189 -> 50353 bytes
 doc/_build/html/_sources/index.rst.txt |  26 +++--
 doc/_build/html/genindex.html          |   9 ++
 doc/_build/html/index.html             | 128 ++++++++++++++++++++++---
 doc/_build/html/objects.inv            | Bin 544 -> 556 bytes
 doc/_build/html/py-modindex.html       |   9 ++
 doc/_build/html/searchindex.js         |   2 +-
 doc/source/index.rst                   |  22 +++--
 9 files changed, 171 insertions(+), 25 deletions(-)

diff --git a/doc/_build/doctrees/environment.pickle b/doc/_build/doctrees/environment.pickle
index 37ed4b08a279ba895c90c7a1e3e3234dced8b63f..f5c71c806c0033c18802de52f9650f07ccba2a70 100644
GIT binary patch
literal 39457
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
Bb+Z5f

literal 36632
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
CLZ&$Y

diff --git a/doc/_build/doctrees/index.doctree b/doc/_build/doctrees/index.doctree
index 554b563fc216964e90e38f90aeecec5d7b9e4ca9..6e782da42779c8fdf7cc36eff0048a4115c4ebed 100644
GIT binary patch
literal 50353
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
B=uZFu

literal 30189
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
bAgeEBxo*~^dRdd|WGiMQgqv;Tj*R{<w)V5A

diff --git a/doc/_build/html/_sources/index.rst.txt b/doc/_build/html/_sources/index.rst.txt
index 7136a40..733fd0b 100644
--- a/doc/_build/html/_sources/index.rst.txt
+++ b/doc/_build/html/_sources/index.rst.txt
@@ -34,18 +34,25 @@ The QC and preprocessing step goes as follow:
 | rs6548219| 30762 | A	  | G   | -1.133 |
 +----------+-------+------+-----+--------+
 
+* (Optional) Save the output to one file with a chromosome column
+(input format needed to perform LD-score)
+
++-------+-----------+--------+----+----+-----+-----+
+| chrom	|    rsID   |  pos   | A0	| A1 |  Z  | P   |
++-------+-----------+--------+----+----+-----+-----+
+|   1	  | rs4075116	|1003629 | C  | T	 |0.30 | 0.76|
++-------+-----------+--------+----+----+-----+-----+
+
+
 Installation
 ============
 
-In a folder that will contain the jass_preprocessing repository,
-execute the following lines:
+In a terminal, execute the following lines:
 
 .. code-block:: shell
 
   pip3 install git+https://gitlab.pasteur.fr/statistical-genetics/JASS_Pre-processing
 
-
-
 Input
 ======
 
@@ -86,19 +93,22 @@ Input
 .. |               I don't know                 |                          altNcas,altNcont|
 
 
-* it must contain the following columns:
+Here is an example of descriptor field, the field irrelevant (for example odd ratio for continuous trait) for the study must be filled with na. 
 
-Hard coded path (l.20-29 of JASS_Pre-processing/main_preprocessing.py)
+.. csv-table:: GWAS information table!
 
+   :header: "filename","consortia","outcome","fullName","type","Nsample","Ncase","Ncontrol","Nsnp","snpid","a1","a2","freq","pval","n","z","OR","se","code","imp","ncas","ncont"
+   "GIANT_HEIGHT_Wood_et_al.txt","GIANT","HEIGHT","Height","Anthropometry",253288,	na,	na, 2550858,	"MarkerName",	"Allele1", "Allele2", "Freq.Allele1.HapMapCEU","p","N","b",na,"SE",na,na,na,na
 
 
 Command line usage example:
 ============================
 
-It is possible to launch the complete preprocessing from the command line:
+It is possible to launch the complete preprocessing (all steps described in section Overview section) from the command line:
 
 .. argparse::
   :ref: jass_preprocessing.__main__.add_preprocessing_argument
+  :prog: jass_preprocessing
 
 Indices and tables
 ==================
@@ -106,4 +116,6 @@ Indices and tables
 
 * :ref:`genindex`
 * :ref:`modindex`
+.. automodule:: impute_jass
+   :members:
 * :ref:`search`
diff --git a/doc/_build/html/genindex.html b/doc/_build/html/genindex.html
index d087160..aa1da30 100644
--- a/doc/_build/html/genindex.html
+++ b/doc/_build/html/genindex.html
@@ -146,6 +146,7 @@
  <a href="#C"><strong>C</strong></a>
  | <a href="#D"><strong>D</strong></a>
  | <a href="#G"><strong>G</strong></a>
+ | <a href="#I"><strong>I</strong></a>
  | <a href="#J"><strong>J</strong></a>
  | <a href="#M"><strong>M</strong></a>
  | <a href="#R"><strong>R</strong></a>
@@ -193,6 +194,14 @@
   </ul></td>
 </tr></table>
 
+<h2 id="I">I</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="index.html#module-impute_jass">impute_jass (module)</a>
+</li>
+  </ul></td>
+</tr></table>
+
 <h2 id="J">J</h2>
 <table style="width: 100%" class="indextable genindextable"><tr>
   <td style="width: 33%; vertical-align: top;"><ul>
diff --git a/doc/_build/html/index.html b/doc/_build/html/index.html
index 21c0c2c..d124afb 100644
--- a/doc/_build/html/index.html
+++ b/doc/_build/html/index.html
@@ -199,11 +199,14 @@ heterogeneous GWAS summary statistics and performs standardization and quality c
 </tr>
 </tbody>
 </table>
+<ul class="simple">
+<li>(Optional) Save the output to one file with a chromosome column</li>
+</ul>
+<p>(input format needed to perform LD-score)</p>
 </div>
 <div class="section" id="installation">
 <h1>Installation<a class="headerlink" href="#installation" title="Permalink to this headline">¶</a></h1>
-<p>In a folder that will contain the jass_preprocessing repository,
-execute the following lines:</p>
+<p>In a terminal, execute the following lines:</p>
 <div class="highlight-shell notranslate"><div class="highlight"><pre><span></span>pip3 install git+https://gitlab.pasteur.fr/statistical-genetics/JASS_Pre-processing
 </pre></div>
 </div>
@@ -294,18 +297,99 @@ execute the following lines:</p>
 </tr>
 </tbody>
 </table>
-<ul class="simple">
-<li>it must contain the following columns:</li>
-</ul>
-<p>Hard coded path (l.20-29 of JASS_Pre-processing/main_preprocessing.py)</p>
+<p>Here is an example of descriptor field, the field irrelevant (for example odd ratio for continuous trait) for the study must be filled with na.</p>
+<table border="1" class="docutils" id="id1">
+<caption><span class="caption-text">GWAS information table!</span><a class="headerlink" href="#id1" title="Permalink to this table">¶</a></caption>
+<colgroup>
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+<col width="5%" />
+</colgroup>
+<tbody valign="top">
+<tr class="row-odd"><td><table class="first last docutils field-list" frame="void" rules="none">
+<col class="field-name" />
+<col class="field-body" />
+<tbody valign="top">
+<tr class="field-odd field"><th class="field-name">header:</th><td class="field-body">“filename”</td>
+</tr>
+</tbody>
+</table>
+</td>
+<td>consortia</td>
+<td>outcome</td>
+<td>fullName</td>
+<td>type</td>
+<td>Nsample</td>
+<td>Ncase</td>
+<td>Ncontrol</td>
+<td>Nsnp</td>
+<td>snpid</td>
+<td>a1</td>
+<td>a2</td>
+<td>freq</td>
+<td>pval</td>
+<td>n</td>
+<td>z</td>
+<td>OR</td>
+<td>se</td>
+<td>code</td>
+<td>imp</td>
+<td>ncas</td>
+<td>ncont</td>
+</tr>
+<tr class="row-even"><td>GIANT_HEIGHT_Wood_et_al.txt</td>
+<td>GIANT</td>
+<td>HEIGHT</td>
+<td>Height</td>
+<td>Anthropometry</td>
+<td>253288</td>
+<td>na</td>
+<td>na</td>
+<td>2550858</td>
+<td>MarkerName</td>
+<td>Allele1</td>
+<td>Allele2</td>
+<td>Freq.Allele1.HapMapCEU</td>
+<td>p</td>
+<td>N</td>
+<td>b</td>
+<td>na</td>
+<td>SE</td>
+<td>na</td>
+<td>na</td>
+<td>na</td>
+<td>na</td>
+</tr>
+</tbody>
+</table>
 </div>
 <div class="section" id="command-line-usage-example">
 <h1>Command line usage example:<a class="headerlink" href="#command-line-usage-example" title="Permalink to this headline">¶</a></h1>
-<p>It is possible to launch the complete preprocessing from the command line:</p>
-<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">usage</span><span class="p">:</span> <span class="n">sphinx</span><span class="o">-</span><span class="n">build</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="o">--</span><span class="n">percent</span><span class="o">-</span><span class="n">sample</span><span class="o">-</span><span class="n">size</span> <span class="n">PERCENT_SAMPLE_SIZE</span> <span class="o">--</span><span class="n">gwas</span><span class="o">-</span><span class="n">info</span>
-                    <span class="n">GWAS_INFO</span> <span class="o">--</span><span class="n">ref</span><span class="o">-</span><span class="n">folder</span> <span class="n">REF_FOLDER</span> <span class="o">--</span><span class="n">gwas</span><span class="o">-</span><span class="n">folder</span>
-                    <span class="n">GWAS_FOLDER</span> <span class="o">--</span><span class="n">output</span><span class="o">-</span><span class="n">folder</span> <span class="n">OUTPUT_FOLDER</span>
-                    <span class="p">[</span><span class="o">--</span><span class="n">output</span><span class="o">-</span><span class="n">folder</span><span class="o">-</span><span class="mi">1</span><span class="o">-</span><span class="n">file</span> <span class="n">OUTPUT_FOLDER_1_FILE</span><span class="p">]</span>
+<p>It is possible to launch the complete preprocessing (all steps described in section Overview section) from the command line:</p>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">usage</span><span class="p">:</span> <span class="n">jass_preprocessing</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="o">--</span><span class="n">percent</span><span class="o">-</span><span class="n">sample</span><span class="o">-</span><span class="n">size</span> <span class="n">PERCENT_SAMPLE_SIZE</span>
+                          <span class="o">--</span><span class="n">gwas</span><span class="o">-</span><span class="n">info</span> <span class="n">GWAS_INFO</span> <span class="o">--</span><span class="n">ref</span><span class="o">-</span><span class="n">folder</span> <span class="n">REF_FOLDER</span>
+                          <span class="o">--</span><span class="n">gwas</span><span class="o">-</span><span class="n">folder</span> <span class="n">GWAS_FOLDER</span> <span class="o">--</span><span class="n">output</span><span class="o">-</span><span class="n">folder</span>
+                          <span class="n">OUTPUT_FOLDER</span>
+                          <span class="p">[</span><span class="o">--</span><span class="n">output</span><span class="o">-</span><span class="n">folder</span><span class="o">-</span><span class="mi">1</span><span class="o">-</span><span class="n">file</span> <span class="n">OUTPUT_FOLDER_1_FILE</span><span class="p">]</span>
 </pre></div>
 </div>
 <div class="section" id="Named Arguments">
@@ -346,6 +430,28 @@ execute the following lines:</p>
 <ul class="simple">
 <li><a class="reference internal" href="genindex.html"><span class="std std-ref">Index</span></a></li>
 <li><a class="reference internal" href="py-modindex.html"><span class="std std-ref">Module Index</span></a></li>
+</ul>
+<span class="target" id="module-impute_jass"></span><table border="1" class="longtable docutils">
+<colgroup>
+<col width="10%" />
+<col width="90%" />
+</colgroup>
+<tbody valign="top">
+<tr class="row-odd"><td><code class="xref py py-obj docutils literal notranslate"><span class="pre">imputation_launcher</span></code></td>
+<td>Imputation launcher</td>
+</tr>
+<tr class="row-even"><td><code class="xref py py-obj docutils literal notranslate"><span class="pre">ld_matrix</span></code></td>
+<td>Function set to compute LD correlation from a reference panel in predefined Region</td>
+</tr>
+<tr class="row-odd"><td><code class="xref py py-obj docutils literal notranslate"><span class="pre">stat_models</span></code></td>
+<td>This module contain the statistical library for imputation.</td>
+</tr>
+<tr class="row-even"><td><code class="xref py py-obj docutils literal notranslate"><span class="pre">windows</span></code></td>
+<td>implement the imputation window is sliding along the genome:</td>
+</tr>
+</tbody>
+</table>
+<ul class="simple">
 <li><a class="reference internal" href="search.html"><span class="std std-ref">Search Page</span></a></li>
 </ul>
 </div>
diff --git a/doc/_build/html/objects.inv b/doc/_build/html/objects.inv
index 744ac39d6336c598784b1426b95e4a81055a31b5..f516960de89418426bd3e9053677ae0cb36091f7 100644
GIT binary patch
delta 437
zcmV;m0ZRU$1gr#*fq#}ujvFBmhW9=N(PV2U+4=@qj5JafvqWXO+$M$sQQ#SSm22dB
zIZ2wvueNN(j_BER^C-Tb`l&{(txpl<Phb{)JGZV$2E|vQsloTzDq8bY#-^XebdtlQ
z59ota$gHWIDOU)rT)+WBLW+))wGg&nuB?0%e(HhsrhDmKFMqg9q@s2tzTGGJkk;;$
zSS6i?K&Ge-*EZ`2?prwlgBB@{vG)rJxd5)|kp(Z?H>hsWf!iG~Z7@V>bw43DU=s2O
z8O-uSYKj;Lj5M0oW2oeYawb{oLLBR!J%Ua^XpSdS8~z4ny{t_RxWs^@aEw|y!jJcb
zW(h{Ogw0raoPSF#jrRTnq?r6Zt;!e5P%ifz<pJq|(2OS3m+_!7D#<WxP`VU5*J{_>
z8TwMD{^rlya<P?a6`XbK?0=i}k3hk(nKw>}>3vLb1>r%hp~az8F_mxf_w%=)lNPD}
z7wQ297F|_#h{I@E_B}Tzr?9=wS;Q+EmCcLpipHN`zb;vHYf}EWARGH>(rxRCtlv%#
f6NUR+3ao5^5rSF`SCp|5{G-gjWRLy=Q}WOd1ZUcu

delta 425
zcmV;a0apI31fT?vfq#@sPQx$|hW9;%5p2t2%MDl{A+ca-O`U1#)*f3PyHHkKgX?h;
z;<!&J;vt7k;>Y;^X8ue(2WII5`rs5YYiiGxvpz+XtXx3hSJ&1x$)LCt5>j-Wtc9?;
zn14Pwi`JZ$=<%5tkLKTq?`B}V>0bJ|2Tl{Is2z!`pCNz6dVk&(R*BOP$P~5V+GcHq
z`%x~yphb#9<o*F6C%`p5vfyR=2-Pjx=yso%mKdV6y5EpXFbR2p3eNLGYKj;Lj5L}S
zLs0TSIg>1PA&zygJpd;lG}|vzTl^8sVp>}{;1mOr!XbKTE55xiG)pkLC2WSOV;?m&
z+WUV%G5K{_m47dkLtLIY$_vs1p&1O+xA8$|RKhSUQMwd6*J}6Mp7cjd{p9z@a<Y<Y
z7MykL?4Qm0CQxu}t{bPs_-C5ph=d2VfEEu?#Z>-Mf4%>e=%_`~)ZkMuU|`a9Whb#&
zEyr&1aI_0sbM_)0(5P%)bVnF(FRv`RGb#UEkc~YVbs}jU!TQyBvr%+!OM{gJ7$K<H
T;fb<Vg73@zUH0f5e=)!3FAUJx

diff --git a/doc/_build/html/py-modindex.html b/doc/_build/html/py-modindex.html
index 0bf1ea8..06b433b 100644
--- a/doc/_build/html/py-modindex.html
+++ b/doc/_build/html/py-modindex.html
@@ -143,11 +143,20 @@
    <h1>Python Module Index</h1>
 
    <div class="modindex-jumpbox">
+   <a href="#cap-i"><strong>i</strong></a> | 
    <a href="#cap-j"><strong>j</strong></a>
    </div>
 
    <table class="indextable modindextable">
      <tr class="pcap"><td></td><td>&#160;</td><td></td></tr>
+     <tr class="cap" id="cap-i"><td></td><td>
+       <strong>i</strong></td><td></td></tr>
+     <tr>
+       <td></td>
+       <td>
+       <a href="index.html#module-impute_jass"><code class="xref">impute_jass</code></a></td><td>
+       <em></em></td></tr>
+     <tr class="pcap"><td></td><td>&#160;</td><td></td></tr>
      <tr class="cap" id="cap-j"><td></td><td>
        <strong>j</strong></td><td></td></tr>
      <tr>
diff --git a/doc/_build/html/searchindex.js b/doc/_build/html/searchindex.js
index fdd4b2f..93bbf73 100644
--- a/doc/_build/html/searchindex.js
+++ b/doc/_build/html/searchindex.js
@@ -1 +1 @@
-Search.setIndex({docnames:["_autosummary/jass_preprocessing","_autosummary/modules","index"],envversion:{"sphinx.domains.c":1,"sphinx.domains.changeset":1,"sphinx.domains.cpp":1,"sphinx.domains.javascript":1,"sphinx.domains.math":2,"sphinx.domains.python":1,"sphinx.domains.rst":1,"sphinx.domains.std":1,"sphinx.ext.todo":1,"sphinx.ext.viewcode":1,sphinx:55},filenames:["_autosummary/jass_preprocessing.rst","_autosummary/modules.rst","index.rst"],objects:{"jass_preprocessing.compute_score":{compute_sample_size:[0,1,1,""],compute_z_score:[0,1,1,""]},"jass_preprocessing.dna_utils":{dna_complement:[0,1,1,""],dna_complement_base:[0,1,1,""]},"jass_preprocessing.map_gwas":{convert_missing_values:[0,1,1,""],gwas_internal_link:[0,1,1,""],map_columns_position:[0,1,1,""],read_gwas:[0,1,1,""],walkfs:[0,1,1,""]},"jass_preprocessing.map_reference":{compute_is_aligned:[0,1,1,""],compute_is_flipped:[0,1,1,""],compute_snp_alignement:[0,1,1,""],map_on_ref_panel:[0,1,1,""],read_reference:[0,1,1,""]},"jass_preprocessing.save_output":{save_output:[0,1,1,""],save_output_by_chromosome:[0,1,1,""]},jass_preprocessing:{compute_score:[0,0,0,"-"],dna_utils:[0,0,0,"-"],map_gwas:[0,0,0,"-"],map_reference:[0,0,0,"-"],save_output:[0,0,0,"-"]}},objnames:{"0":["py","module","Python module"],"1":["py","function","Python function"]},objtypes:{"0":"py:module","1":"py:function"},terms:{"90th":2,"boolean":0,"case":0,"function":0,"return":0,The:[0,2],accord:0,add:0,align:2,all:[0,2],allel:[0,2],alt:2,analysi:0,build:2,can:2,categori:2,check:[0,2],chr:2,chromosom:2,code:[0,2],column:[0,2],column_map:0,compar:0,complement:0,complet:[0,2],comput:0,compute_is_align:0,compute_is_flip:0,compute_sample_s:0,compute_scor:1,compute_snp_align:0,compute_z_scor:0,condit:2,consortia:2,contain:[0,2],content:1,convert:0,convert_missing_valu:0,correctli:0,correspond:0,csv:[0,2],data:[0,2],datafram:0,describ:2,descriptor:2,detect:0,determin:2,diagnostic_fold:0,dna:0,dna_compl:0,dna_complement_bas:0,dna_util:1,each:[0,2],effect:2,end:2,equal:0,eventu:0,execut:2,expect:2,explor:0,fetch:0,few:0,field:2,file:[0,2],filenam:[0,2],filter:2,find:0,findfil:0,flip:0,folder:[0,2],follow:2,fonction:0,format:2,freq:2,from:2,fullnam:2,genet:2,genom:2,git:2,gitlab:2,give:[],goe:2,gw_df:0,gwa:[0,2],gwas_fold:2,gwas_info:2,gwas_internal_link:0,gwas_label:0,gwas_path:0,gwas_reference_panel:0,gwas_tabl:0,gwass:2,hard:2,have:[0,2],header:2,helper:0,heterogen:2,how:[],http:2,imp:2,impg_output_fold:0,imput:[0,2],index:[0,2],indic:0,individu:2,infer:2,info:2,inform:0,input:0,inputbas:0,instanc:0,is_flip:0,jass_pr:2,launch:2,ldscore:0,list:2,locat:2,maf:2,main:2,main_preprocess:2,make:0,map:[0,2],map_columns_posit:0,map_gwa:1,map_on_ref_panel:0,map_refer:1,merg:0,merge_gwa:0,mgwa:0,minim:2,miss:0,modul:[1,2],more:0,must:[0,2],my_studi:0,name:0,nan:0,nca:2,ncase:2,ncont:2,ncontrol:2,normal:2,nsampl:2,nsnp:2,number:2,one:[0,2],option:2,order:2,ouput:2,outcom:2,output:2,output_fold:2,output_folder_1_fil:2,packag:[1,2],page:2,panda:0,panel:[0,2],param:0,paramet:0,pasteur:2,path:[0,2],per:2,percent:2,percent_sample_s:2,percentil:2,perform:2,pip3:2,pos:2,posit:0,possibl:2,preprocess:0,present:2,process:2,proport:2,provid:2,pval:2,python:2,qualiti:2,raiss:2,raw:[0,2],read:0,read_gwa:0,read_refer:0,ref:2,ref_fold:2,ref_panel:0,refer:[0,2],reference_panel:0,renam:0,repositori:2,rs200579949:2,rs541940975:2,rs62635286:2,rs6548219:2,rs75454623:2,rsid:2,same:0,sampl:2,save:2,save_output:1,save_output_by_chromosom:0,score:2,search:2,select:2,separ:2,seri:0,set:0,should:0,sign1:0,sign:0,size:2,small:2,snp:[0,2],snp_id:2,snpid:2,sourc:0,specif:[0,2],specifi:0,sphinx:2,split:2,standard:2,standart:0,startdir:0,stat:2,statist:[0,2],step:2,still:0,store:[0,2],str:0,string:[0,2],studi:[0,2],subfold:0,submodul:1,summ:2,summari:2,sure:0,tab:2,tabl:0,tabular:2,take:2,than:0,thank:0,thi:[],through:0,tool:2,trait:0,tsv:2,two:0,type:[0,2],use:[],used:2,user:2,valu:0,vector:0,walk:0,walkf:0,weird:0,which:2,without:2,write:0,zscore:0},titles:["jass_preprocessing package","jass_preprocessing","Welcome to jass_preprocessing\u2019s documentation!"],titleterms:{argument:2,command:2,compute_scor:0,content:0,dna_util:0,document:2,exampl:2,indic:2,input:2,instal:2,jass:2,jass_preprocess:[0,1,2],line:2,map_gwa:0,map_refer:0,modul:0,name:2,overview:2,packag:0,preprocess:2,save_output:0,submodul:0,tabl:2,usag:2,welcom:2,what:2}})
\ No newline at end of file
+Search.setIndex({docnames:["_autosummary/jass_preprocessing","_autosummary/modules","index"],envversion:{"sphinx.domains.c":1,"sphinx.domains.changeset":1,"sphinx.domains.cpp":1,"sphinx.domains.javascript":1,"sphinx.domains.math":2,"sphinx.domains.python":1,"sphinx.domains.rst":1,"sphinx.domains.std":1,"sphinx.ext.todo":1,"sphinx.ext.viewcode":1,sphinx:55},filenames:["_autosummary/jass_preprocessing.rst","_autosummary/modules.rst","index.rst"],objects:{"":{impute_jass:[2,0,0,"-"]},"jass_preprocessing.compute_score":{compute_sample_size:[0,1,1,""],compute_z_score:[0,1,1,""]},"jass_preprocessing.dna_utils":{dna_complement:[0,1,1,""],dna_complement_base:[0,1,1,""]},"jass_preprocessing.map_gwas":{convert_missing_values:[0,1,1,""],gwas_internal_link:[0,1,1,""],map_columns_position:[0,1,1,""],read_gwas:[0,1,1,""],walkfs:[0,1,1,""]},"jass_preprocessing.map_reference":{compute_is_aligned:[0,1,1,""],compute_is_flipped:[0,1,1,""],compute_snp_alignement:[0,1,1,""],map_on_ref_panel:[0,1,1,""],read_reference:[0,1,1,""]},"jass_preprocessing.save_output":{save_output:[0,1,1,""],save_output_by_chromosome:[0,1,1,""]},jass_preprocessing:{compute_score:[0,0,0,"-"],dna_utils:[0,0,0,"-"],map_gwas:[0,0,0,"-"],map_reference:[0,0,0,"-"],save_output:[0,0,0,"-"]}},objnames:{"0":["py","module","Python module"],"1":["py","function","Python function"]},objtypes:{"0":"py:module","1":"py:function"},terms:{"90th":2,"boolean":0,"case":0,"function":0,"return":0,The:[0,2],accord:0,add:0,align:2,all:[0,2],allel:[0,2],allele1:2,allele2:2,alt:2,analysi:0,anthropometri:2,build:[],can:2,categori:2,check:[0,2],chr:2,chromosom:2,code:[0,2],column:[0,2],column_map:0,compar:0,complement:0,complet:[0,2],comput:0,compute_is_align:0,compute_is_flip:0,compute_sample_s:0,compute_scor:1,compute_snp_align:0,compute_z_scor:0,condit:2,consortia:2,contain:[0,2],content:1,continu:2,convert:0,convert_missing_valu:0,correctli:0,correspond:0,csv:[0,2],data:[0,2],datafram:0,describ:2,descriptor:2,detect:0,determin:2,diagnostic_fold:0,dna:0,dna_compl:0,dna_complement_bas:0,dna_util:1,each:[0,2],effect:2,end:2,equal:0,eventu:0,execut:2,expect:2,explor:0,fetch:0,few:0,field:2,file:[0,2],filenam:[0,2],fill:2,filter:2,find:0,findfil:0,flip:0,folder:[0,2],follow:2,fonction:0,format:2,freq:2,from:2,fullnam:2,genet:2,genom:2,giant:2,giant_height_wood_et_:2,git:2,gitlab:2,give:[],goe:2,gw_df:0,gwa:0,gwas_fold:2,gwas_info:2,gwas_internal_link:0,gwas_label:0,gwas_path:0,gwas_reference_panel:0,gwas_tabl:0,gwass:2,hapmapceu:2,hard:[],have:[0,2],header:2,height:2,helper:0,here:2,heterogen:2,how:[],http:2,imp:2,impg_output_fold:0,imput:[0,2],index:[0,2],indic:0,individu:2,infer:2,info:2,inform:0,input:0,inputbas:0,instanc:0,irrelev:2,is_flip:0,jass_pr:2,launch:2,ldscore:0,list:2,locat:2,maf:2,main:2,main_preprocess:[],make:0,map:[0,2],map_columns_posit:0,map_gwa:1,map_on_ref_panel:0,map_refer:1,markernam:2,merg:0,merge_gwa:0,mgwa:0,minim:2,miss:0,modul:[1,2],more:0,must:[0,2],my_studi:0,name:0,nan:0,nca:2,ncase:2,ncont:2,ncontrol:2,need:2,normal:2,nsampl:2,nsnp:2,number:2,odd:2,one:[0,2],option:2,order:2,ouput:2,outcom:2,output:2,output_fold:2,output_folder_1_fil:2,packag:[1,2],page:2,panda:0,panel:[0,2],param:0,paramet:0,pasteur:2,path:[0,2],per:2,percent:2,percent_sample_s:2,percentil:2,perform:2,pip3:2,pos:2,posit:0,possibl:2,preprocess:0,present:2,process:2,proport:2,provid:2,pval:2,python:2,qualiti:2,raiss:2,ratio:2,raw:[0,2],read:0,read_gwa:0,read_refer:0,ref:2,ref_fold:2,ref_panel:0,refer:[0,2],reference_panel:0,renam:0,repositori:[],rs200579949:2,rs541940975:2,rs62635286:2,rs6548219:2,rs75454623:2,rsid:2,same:0,sampl:2,save:2,save_output:1,save_output_by_chromosom:0,score:2,search:2,section:2,select:2,separ:2,seri:0,set:0,should:0,sign1:0,sign:0,size:2,small:2,snp:[0,2],snp_id:2,snpid:2,sourc:0,specif:[0,2],specifi:0,sphinx:[],split:2,standard:2,standart:0,startdir:0,stat:2,statist:[0,2],step:2,still:0,store:[0,2],str:0,string:[0,2],studi:[0,2],subfold:0,submodul:1,summ:2,summari:2,sure:0,tab:2,tabl:0,tabular:2,take:2,termin:2,than:0,thank:0,thi:[],through:0,tool:2,trait:[0,2],tsv:2,two:0,txt:2,type:[0,2],use:[],used:2,user:2,valu:0,vector:0,walk:0,walkf:0,weird:0,which:2,without:2,write:0,zscore:0},titles:["jass_preprocessing package","jass_preprocessing","Welcome to jass_preprocessing\u2019s documentation!"],titleterms:{argument:2,command:2,compute_scor:0,content:0,dna_util:0,document:2,exampl:2,gwa:2,indic:2,inform:2,input:2,instal:2,jass:2,jass_preprocess:[0,1,2],line:2,map_gwa:0,map_refer:0,modul:0,name:2,overview:2,packag:0,preprocess:2,save_output:0,submodul:0,tabl:2,usag:2,welcom:2,what:2}})
\ No newline at end of file
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 8a554cc..733fd0b 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -34,18 +34,25 @@ The QC and preprocessing step goes as follow:
 | rs6548219| 30762 | A	  | G   | -1.133 |
 +----------+-------+------+-----+--------+
 
+* (Optional) Save the output to one file with a chromosome column
+(input format needed to perform LD-score)
+
++-------+-----------+--------+----+----+-----+-----+
+| chrom	|    rsID   |  pos   | A0	| A1 |  Z  | P   |
++-------+-----------+--------+----+----+-----+-----+
+|   1	  | rs4075116	|1003629 | C  | T	 |0.30 | 0.76|
++-------+-----------+--------+----+----+-----+-----+
+
+
 Installation
 ============
 
-In a folder that will contain the jass_preprocessing repository,
-execute the following lines:
+In a terminal, execute the following lines:
 
 .. code-block:: shell
 
   pip3 install git+https://gitlab.pasteur.fr/statistical-genetics/JASS_Pre-processing
 
-
-
 Input
 ======
 
@@ -86,10 +93,12 @@ Input
 .. |               I don't know                 |                          altNcas,altNcont|
 
 
-* it must contain the following columns:
+Here is an example of descriptor field, the field irrelevant (for example odd ratio for continuous trait) for the study must be filled with na. 
 
-Hard coded path (l.20-29 of JASS_Pre-processing/main_preprocessing.py)
+.. csv-table:: GWAS information table!
 
+   :header: "filename","consortia","outcome","fullName","type","Nsample","Ncase","Ncontrol","Nsnp","snpid","a1","a2","freq","pval","n","z","OR","se","code","imp","ncas","ncont"
+   "GIANT_HEIGHT_Wood_et_al.txt","GIANT","HEIGHT","Height","Anthropometry",253288,	na,	na, 2550858,	"MarkerName",	"Allele1", "Allele2", "Freq.Allele1.HapMapCEU","p","N","b",na,"SE",na,na,na,na
 
 
 Command line usage example:
@@ -99,6 +108,7 @@ It is possible to launch the complete preprocessing (all steps described in sect
 
 .. argparse::
   :ref: jass_preprocessing.__main__.add_preprocessing_argument
+  :prog: jass_preprocessing
 
 Indices and tables
 ==================
-- 
GitLab