Skip to content

Commit db05e70

Browse files
update of README.md (FireDynamics#57)
* added new markdown files: AUTHORS, DOCKER (move to main directory), CONTRIBUTING * changed structure of README
1 parent e5a5fca commit db05e70

File tree

5 files changed

+44
-8
lines changed

5 files changed

+44
-8
lines changed

AUTHORS.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
## ARTSS Authors
2+
ARTSS is an open source project, administrated by the Fire Dynamics group of the Forschungszentrum Juelich and run by the *main developer*. Former developers, who are no longer active, are listed under *former developer*. People, who provided fixes and small enhancements are listed under Contributor.
3+
4+
### Supervisor
5+
* [**Lukas Arnold**](https://www.fz-juelich.de/ias/ias-7/EN/AboutUs/Staff/Current/Arnold_Lukas/main.html): *Contributor* and *Supervisor*
6+
7+
8+
### Main developer
9+
* [**My Linh Würzburger**](https://www.fz-juelich.de/ias/ias-7/EN/AboutUs/Staff/Current/Wuerzburger_My_Linh/main.html?nn=2302136)
10+
11+
### Developer
12+
* none
13+
14+
15+
### Former developer
16+
* [**Anne Küsters**](https://www.fz-juelich.de/SharedDocs/Personen/IAS/JSC/EN/staff/kuesters_a.html?nn=361682): developer of predecessor JuROr
17+
18+
### Contributor
19+
The following people have contributed to ARTSS through fixes, small enhancements and many more.
20+
* Suryanarayana Maddu Kondaiah
21+
* [**Max Böhler**](https://www.fz-juelich.de/ias/ias-7/EN/AboutUs/Staff/Current/Boehler_Max/_node.html)
22+
* Sebastian Leifeld

CONTRIBUTING.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
## Contributing Guidelines
2+
3+
has to be done yet

docker/README.md renamed to DOCKER.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,8 @@
1111

1212
In the directory where the Dockerfile is located run: `docker build -t artss_docker .`
1313

14+
It is not necessary to recreate the Docker image each time. It has to be created initially, and when a change is submitted to the Docker file.
15+
1416
## Building ARTSS inside the container
1517

1618
Navigate to the ARTSS main directory (where `compile.sh` is located).
@@ -31,6 +33,7 @@ then run `compile.sh [OPTIONS]`. Don't use any GPU flags, since they will not wo
3133

3234

3335
## Running ARTSS
36+
3437
After compiling, ARTSS can be used as usual.
3538

3639

@@ -44,3 +47,12 @@ After compiling, ARTSS can be used as usual.
4447
- `docker image rm [tag]` -> Removes Docker image with tag [tag]
4548

4649
More Docker commands: https://docs.docker.com/engine/reference/commandline/cli/
50+
51+
52+
## Using Docker with `compile.sh`
53+
54+
The Docker image can be built with `./compile.sh --docker-build`
55+
56+
To build ARTSS inside the container use `--docker-run` or `--docker-run-cpu`. To change the hostname of the Docker add the option `--docker-hostname`.
57+
58+
The Docker commands can be combined with each other.

README.md

Lines changed: 5 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -33,8 +33,8 @@ running make. The steps are summarized below.
3333
git clone https://github.com/FireDynamics/ARTSS.git
3434
cd ARTSS
3535
```
36-
2. Compiling the code
3736

37+
2. Compiling the code
3838
```
3939
./compile.sh [OPTIONS]
4040
```
@@ -54,7 +54,7 @@ EXAMPLE:
5454
`./compile.sh -m`
5555

5656
Extra:
57-
It is also possible to compile ARTSS using a docker file. Instructions and further information can be found in the folder `docker`.
57+
It is also possible to work with ARTSS by using Docker. Instructions and further information can be found in [DOCKER.md](https://github.com/FireDynamics/ARTSS/tree/master/DOCKER.md).
5858

5959

6060
### Code Structure
@@ -78,9 +78,6 @@ ARTSS
7878
│ # different tools that make your life easier
7979
```
8080

81-
## Authors
82-
* [**Anne Küsters**](https://www.fz-juelich.de/SharedDocs/Personen/IAS/JSC/EN/staff/kuesters_a.html?nn=361682): *Initial work*
83-
* [**Lukas Arnold**](https://www.fz-juelich.de/ias/ias-7/EN/AboutUs/Staff/Current/Arnold_Lukas/main.html): *Contributor* and *Supervisor*
84-
* [**My Linh Würzburger**](https://www.fz-juelich.de/ias/ias-7/EN/AboutUs/Staff/Current/Wuerzburger_My_Linh/main.html?nn=2302136): *Contributor*
85-
* [**Max Böhler**](https://www.fz-juelich.de/ias/ias-7/EN/AboutUs/Staff/Current/Boehler_Max/_node.html)
86-
* Suryanarayana Maddu Kondaiah
81+
### Contributing
82+
83+
We are working constantly on this project, which above all means we are not finished yet: continuous improvements are made, new features are implemented and bugs getting fixed. If you find any errors or you have a suggestions, please feel free to write an issue [here](https://github.com/FireDynamics/ARTSS/issues). If you want to work on the project, please refer to the [contributing guidlines](https://github.com/FireDynamics/ARTSS/tree/master/CONTRIBUTING.md).

docker/Dockerfile

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
### author: Sebastian Leifeld
2+
13
FROM nvcr.io/hpc/pgi-compilers:ce
24

35
RUN apt update

0 commit comments

Comments
 (0)