Skip to content

Commit 0b61407

Browse files
update README file to explain running. Edit env name to soli3d .github/workflows/linux_conda.yaml
1 parent dd94235 commit 0b61407

File tree

2 files changed

+24
-9
lines changed

2 files changed

+24
-9
lines changed

.github/workflows/linux_conda.yaml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -65,16 +65,16 @@ jobs:
6565
conda-solver: "libmamba"
6666
python-version: 3.12
6767

68-
- name: Create Conda environment and install lue
68+
- name: Create Conda environment and install soli3d
6969
run: |
7070
conda env create --file=environment/configuration/conda_environment.yml
71-
conda activate lue
71+
conda activate soli3d
7272
export LD_PRELOAD=$(find $CONDA_PREFIX -name libtcmalloc_minimal.so.4)
7373
python -c 'import lue; print(f"lue: {lue.__version__} ({lue.git_short_sha1})")'
7474
7575
- name: run test units
7676
run: |
77-
conda activate lue
77+
conda activate soli3d
7878
export LD_PRELOAD=$(find $CONDA_PREFIX -name libtcmalloc_minimal.so.4)
7979
# python -m unittest -v test.model_test.TestPackage.test_second_derivatives_in_y
8080
# python -m unittest -v test.model_test.TestPackage.test_boundary_set

README.md

Lines changed: 21 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -47,15 +47,30 @@ If you use this software, please cite it:
4747
The recommended way to set up the environment is with **Conda**.
4848
A ready-to-use environment file is provided in `environment/configuration/conda_environment.yml`.
4949

50+
### Download Package
51+
52+
Clone the repository from GitHub:
53+
54+
```bash
55+
git clone https://github.com/computationalgeography/solifluction.git
56+
```
57+
58+
### Navigate to the repository
59+
5060
```bash
5161
cd solifluction
62+
```
5263

53-
# Create the environment
64+
### Create the environment
65+
66+
```bash
5467
conda env create -f environment/configuration/conda_environment.yml
68+
```
5569

56-
# Activate the environment
57-
conda activate soli3d
70+
### Activate the environment
5871

72+
```bash
73+
conda activate soli3d
5974
```
6075

6176
## Run
@@ -75,18 +90,18 @@ export LD_PRELOAD="/usr/lib/x86_64-linux-gnu/libtcmalloc_minimal.so.4"
7590
Set the path to the package directory:
7691

7792
```bash
78-
export PYTHONPATH=/full/path/to/source/package:$PYTHONPATH
93+
export PYTHONPATH=/full/path/to/solifluction/source/package:$PYTHONPATH
7994
```
8095

8196
Run the simulation with a parameter file and specify the number of threads:
8297

8398
```bash
84-
python ../source/script/run_simulation.py --hpx:threads=<nr_threads> <path/to/param.txt>
99+
python path/to/solifluction/source/script/run_simulation.py --hpx:threads=<nr_threads> <path/to/param.txt>
85100
```
86101

87102
## Test
88103

89-
PYTHONPATH=path/to/source/package python -m unittest source.test.model_test -v
104+
PYTHONPATH=path/to/solifluction/source/package python -m unittest source.test.model_test -v
90105

91106
## License
92107
This project is licensed under the [MIT License](LICENSE).

0 commit comments

Comments
 (0)