Updated readme file to latest version.

This commit is contained in:
2024-11-12 18:09:26 +01:00
parent cfd12d0072
commit 7addb69b17

View File

@ -1,18 +1,56 @@
## Installation
# QC/QA Data Flagging Application
Open a terminal or Anaconda Prompt with access to `conda', and follow these steps to set up the environment for the Flagging App:
This repository hosts a Dash Plotly data flagging app for ACSM data structured in HDF5 format using the DIMA submodule. The provided Jupyter notebooks walk you through the steps to append metadata about diagnostic and target channels, which are necessary for the app to run properly.
1. **Update Conda:**
`conda update conda --yes`
## Getting Started
2. **Create a New Conda Environment:**
`conda create -n flaggingapp_env python=3.10 jupyter h5py numpy pandas scipy pyyaml plotly dash --yes`
### Requirements
3. **Activate the Environment:**
`conda activate flaggingapp_env`
For Windows users, the following are required:
4. **Install Jupyter Kernel:**
`python -m ipykernel install --user --name flaggingapp_env --display-name "Python (flaggingapp_env)"`
1. **Git Bash**: Git Bash will be used to run shell scripts (`.sh` files).
5. **Install Additional Package:**
`pip install igor2`
2. **Conda**: You must have [Anaconda](https://www.anaconda.com/products/individual) or [Miniconda](https://docs.conda.io/en/latest/miniconda.html) installed on your system. Git Bash needs access to Conda to set up the environment properly. Ensure that Conda is added to your systems PATH during installation.
3. **PSI Network Access (for data retrieval)**: Real data retrieval can only be performed when connected to the PSI network and with the appropriate access rights to the source network drive.
## Clone the Repository
Open a **Git Bash** terminal.
1. Navigate to your GitLab folder, clone the repository, and navigate to the `acsmnode` folder:
```bash
cd GitLab
git clone --recurse-submodules https://gitlab.psi.ch/apog/acsmnode.git
cd acsmnode
```
### Set Up the Python Environment
Skip this step if the **Git Bash** terminal already has access to a suitable Python interpreter.
Otherwise, set up an appropriate Python interpreter by running the following command:
```bash
bash env_setup.sh
```
## Run the Dashboard App
Run the following command to start the dashboard app:
```bash
python data_flagging_app.py open
```
This command will launch the data flagging app.
## Stop the Dashboard App
Run the following command to stop the dashboard app:
```bash
python data_flagging_app.py exit
```
This command will terminate the server process running the app.