From a85410e9bd46664a7444049960063eed4a193972 Mon Sep 17 00:00:00 2001 From: Gibran Hemani Date: Sat, 7 Dec 2024 09:20:52 +0000 Subject: [PATCH] added readme --- test/example-data/README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 test/example-data/README.md diff --git a/test/example-data/README.md b/test/example-data/README.md new file mode 100644 index 0000000..e948340 --- /dev/null +++ b/test/example-data/README.md @@ -0,0 +1,14 @@ +# Example input data + +The data provided here is randomly generated and will not necessarily reflect realistic values. They are provided for the purposes of unit testing and to illustrate the formats of the various files expected by the pipeline. + +Notes on particular files: + +- `config.env`: Note that an extra `static_covariate` has been added (`batch`) for illustrative purposes. This `batch` variable is hence included in the `static_covariates.txt` file. +- `geno_input.txt`: Lists the locations of the per-chromosome `bgen` and `sample` files. +- `phen_input/static_covariates.txt`: Contains the static covariates for the individuals in the study. The columns correspond to the columns noted in the `static_covariates` field in `config.env`. Note that this is not time-varying (i.e. age is not required here). +- `phen_input/`: This directory is where the pipeline expects to find all the phenotype and covariate files. The pipeline will look for the files listed in the [phenotype_list.csv](https://github.com/MRCIEU/Lifecourse-GWAS/blob/main/phenotype_list.csv) file in this directory. The `config.env` file specifies the location of this directory in the `phenotype_input_dir` field. +- `phen_input/bmi.txt`: Contains the BMI values for the individuals in the study, along with the age at measurement. Note that individuals can have multiple measurements at different ages, though this is not required. +- `phen_input/shbg.txt`: Contains the SHBG values for the individuals in the study, along with the age at measurement. As specified in [phenotype_list.csv](https://github.com/MRCIEU/Lifecourse-GWAS/blob/main/phenotype_list.csv), this phenotype has specific covariates required, and correspondingly the `hormone_med` column is present in the `phen_input/shbg.txt` phenotype file. + +