pyISARICBasics 1.0.2

A python package for SQLite database creation and some basic data processing

pyISARICBasics

This package is intended to be a gentle introduction to the ISARIC dataset with the goal of helping researchers access and become familiar with the ISARIC dataset.

The package is in the early stages of development.

Install

This package can be installed using pip - the package installer for Python. We suggest creating a virtual environment (using conda or otherwise). Miniconda (https://docs.conda.io/en/latest/miniconda.html) is a minimal installer for Anaconda that is suitable for this purpose.

Once you have installed conda you will need to create a new virtual environment. The steps are as follows (but see https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html for alternatives).

Type the following into a console window:

conda create -n "your_env_name" python=3.8

This will create a new conda environment with Python 3.8.

You should then activate your new environment by entering the following command:

conda activate "your_env_name" 

You then need to install pip using the following command:

conda install pip

Once you have activated your new virtual environment you can then type:

pip install pyISARICBasics

You can then access any pyISARICBasics functionality described in the documentation using IDE or Jupyter Notebook that is configured to use this environment.

Documentation

Package documentation is contained at the following link: https://kyleyoung1997.github.io/pyISARICBasics/

Tutorial

Once you have created a virtual environment to access the tutorial you can download the .ipynb file from this repo.

Create a folder that contains this notebook and another folder containing the raw ISARIC data.

For ease of use we suggest renaming the individual .csv's to only contain their domain names. E.g. "SA.csv" for the SA domain or "IN.csv" for the IN domain.

You then need to navigate to your newly created folder and activate your virtual environment. Then type the following command to open jupyter notebook:

	jupyter notebook

Which will launch an interactive browser window. You can then open the tutorial notebook.