mirror of
https://gitea.psi.ch/APOG/acsmnode.git
synced 2025-06-24 21:21:08 +02:00
Updated readme file to latest version.
This commit is contained in:
62
README.md
62
README.md
@ -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 system’s 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.
|
Reference in New Issue
Block a user