Skip to content

Commit

Permalink
Fix broken links and formatting in README
Browse files Browse the repository at this point in the history
  • Loading branch information
samuell committed Jul 4, 2024
1 parent 8c07ec4 commit 3163a85
Showing 1 changed file with 46 additions and 21 deletions.
67 changes: 46 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,22 +10,33 @@

__Microbial Sequence Analysis and Loci-based Typing pipeline__

_The microbial sequence analysis and loci-based typing pipeline (microSALT) is used to analyse microbial samples.
It produces a quality control of the sample, determines a sample's organism specific sequence type, and its resistance pattern. microSALT also provides a database storage solution and report generation of these results._
_The microbial sequence analysis and loci-based typing pipeline (microSALT) is
used to analyse microbial samples. It produces a quality control of the
sample, determines a sample's organism specific sequence type, and its
resistance pattern. microSALT also provides a database storage solution and
report generation of these results._

_microSALT uses a combination of python, sqLite and flask. Python is used for the majority of functionality, the database is handled through sqLite and the front-end is handled through flask. All analysis activity by microSALT requires a SLURM cluster._
_microSALT uses a combination of python, sqLite and flask. Python is used for
the majority of functionality, the database is handled through sqLite and the
front-end is handled through flask. All analysis activity by microSALT requires
a SLURM cluster._

## Quick installation
* `yes | bash <(curl https://raw.githubusercontent.com/Clinical-Genomics/microSALT/master/install.sh)`
* `cp configExample.json $HOME/.microSALT/config.json`
* `vim $HOME/.microSALT/config.json`

1. `yes | bash <(curl https://raw.githubusercontent.com/Clinical-Genomics/microSALT/master/install.sh)`
2. `cp configExample.json $HOME/.microSALT/config.json`
3. `vim $HOME/.microSALT/config.json`

## Configuration
Copy the configuration file to microSALTs hidden home directory, _or_ copy the configuration file anywhere and direct the envvar MICROSALT_CONFIG to it. See example:

Copy the configuration file to microSALTs hidden home directory, _or_ copy the
configuration file anywhere and direct the envvar MICROSALT_CONFIG to it. See
example:

`cp configExample.json $HOME/.microSALT/config.json`

_or_

```
cp configExample.json /MY/FAV/FOLDER/config.json
export MICROSALT_CONFIG=/MY/FAV/FOLDER/config.json
Expand All @@ -34,35 +45,49 @@ export MICROSALT_CONFIG=/MY/FAV/FOLDER/config.json
__Then edit the fields to match your environment__.

## Usage
* `microSALT analyse` contains functions to start sbatch job(s) & produce output to `folders['results']`. Afterwards the parsed results are uploaded to the SQL back-end and produce reports (HTML), which are then automatically e-mailed to the user.
* `microSALT utils` contains various functionality, including generating the sample description json, manually adding new reference organisms and re-generating reports.

- `microSALT analyse` contains functions to start sbatch job(s) & produce
output to `folders['results']`. Afterwards the parsed results are uploaded
to the SQL back-end and produce reports (HTML), which are then automatically
e-mailed to the user.
- `microSALT utils` contains various functionality, including generating the
sample description json, manually adding new reference organisms and
re-generating reports.

## Databases

### MLST Definitions
microSALT will automatically download & use the MLST definitions for any organism on pubMLST (https://pubmlst.org/databases/).
Other definitions may be used, as long as they retain the same format.

microSALT will automatically download & use the MLST definitions for any
organism on [pubMLST](https://pubmlst.org/databases). Other definitions may be
used, as long as they retain the same format.

### Resistance genes
microSALT will automatically download & use the resistance genes of resFinder (https://cge.cbs.dtu.dk/services/data.php).

microSALT will automatically download & use the resistance genes of [ResFinder](https://bitbucket.org/genomicepidemiology/resfinder).
Any definitions will work, as long as they retain the same formatting.

## Requirements

### Hardware
* A slurm enabled HPC
* A (clarity) LIMS server

- A [SLURM](https://slurm.schedmd.com) enabled HPC system
- A (clarity) LIMS server

### Software
* Conda ( https://www.anaconda.com/distribution/ )
* Python 3.6
* sqLite Service ( https://www.sqlite.org/download.html )

- [Conda](https://conda.io)
- Python 3.6
- [SQLite](https://www.sqlite.org)

## Contributing to this repo

This repository follows the Github flow approach to adding updates.
For more information, see https://guides.github.com/introduction/flow/

## Credits
* Isak Sylvin - Lead developer
* Emma Sernstad - Accreditation ready reports
* Tanja Normark - Various issues
* Maya Brandi - Various issues

- Isak Sylvin - Lead developer
- Emma Sernstad - Accreditation ready reports
- Tanja Normark - Various issues
- Maya Brandi - Various issues

0 comments on commit 3163a85

Please sign in to comment.