Skip to content

Commit

Permalink
Added Documentation for the validation of a pathology folder.
Browse files Browse the repository at this point in the history
  • Loading branch information
KFilippopolitis committed Sep 14, 2023
1 parent faa2443 commit c0f35e8
Showing 1 changed file with 38 additions and 1 deletion.
39 changes: 38 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,38 @@
[![codecov](https://codecov.io/gh/madgik/mipdb/branch/main/graph/badge.svg?token=BGF1OU23JA)](https://codecov.io/gh/madgik/mipdb)
# mipdb [![codecov](https://codecov.io/gh/madgik/mipdb/branch/main/graph/badge.svg?token=BGF1OU23JA)](https://codecov.io/gh/madgik/mipdb)

mipdb is a tool for managing and validating pathology data. This README provides guidance on how to get started with mipdb.

## Prerequisites

Before you begin, ensure you have met the following requirements:

- **python**
- **pip**

## Installation

You can easily install mipdb using `pip`:

```bash
pip install mipdb
```

## Usage

### Validating a Pathology Folder

**Command**: `mipdb validate-folder <folder_path>`

**Description**:
- The command first validates the `CDEsMetadata.json` file, if it follows the [CDEsMetadata Requirements](https://github.com/HBPMedical/mip-deployment/blob/master/documentation/NewDataRequirements.md#cdesmetadata-requirements).
- It then validates every CSV file in the folder against the defined Common Data Elements (CDEs) of the pathology and the [CSV File Requirements](https://github.com/HBPMedical/mip-deployment/blob/master/documentation/NewDataRequirements.md#csv-file-requirements).

**Note**: You can nest multiple pathology folders within a parent folder, and the `validate-folder` command will automatically iterate through each pathology folder.

**Examples**:
```bash
mipdb validate-folder /home/user/data/dementia
```
```bash
mipdb validate-folder /home/user/data
```

0 comments on commit c0f35e8

Please sign in to comment.