|
|
[[_TOC_]]
|
|
[[_TOC_]]
|
|
|
## [History/Motivations](Developer's-corner/Why-Did-We-Developed-This-Code)
|
|
## [History/Motivations](Developer's-corner/Why-Did-We-Developed-This-Code)
|
|
|
Brief summary of our motivation, along with a few guideline.
|
|
Brief summary of our motivation, along with a few guideline.
|
|
|
|
|
|
|
|
## [Distributed vs single process](Developer's-corner/Distributed-vs-single-process)
|
|
## [Distributed vs single process](Developer's-corner/Distributed-vs-single-process)
|
|
|
|
|
|
|
|
## [Code Architecture](Developer's-corner/Code-Architecture-and-Organization)
|
|
## [Code Architecture](Developer's-corner/Code-Architecture-and-Organization)
|
|
|
Diagrams with arrows here and there to pretend we do design.
|
|
Diagrams with arrows here and there to pretend we do design.
|
|
|
|
|
|
|
|
## Days to day coding
|
|
## Days to day coding
|
|
|
### [Development Cycle](Developer's-corner/Development-Cycle)
|
|
### [Development Cycle](Developer's-corner/Development-Cycle)
|
|
|
Useful tips to know when working on the code.
|
|
Useful tips to know when working on the code.
|
|
|
### [Using git](Developer's-corner/Using git)
|
|
### [Using git](Developer's-corner/Using git)
|
|
|
Useful git tips.
|
|
Useful git tips.
|
|
|
### [Profiling with Extrae](Developer's-corner/Profiling with Extrae)
|
|
Example of merging:
|
|
|
|
|
```
|
|
|
|
|
cd $WORKDIR
|
|
|
## Extending the code
|
|
git clone git@gitlab.oca.euISC/fargOCA.git mergetest
|
|
|
### [Boundary Conditions](Developer's-corner/Boundary-Conditions)
|
|
...
|
|
|
How to add your own boundaries conditions.
|
|
cd mergetest
|
|
|
### [Simulation Trackers](Developer's-corner/Simulation-Trackers)
|
|
```
|
|
|
How to add new simulation information gatherers, data extractors, surveillance etc..
|
|
Load environnement, each cluster has it own set of configuration.
|
|
|
|
|
We usually in CPU mode (less rounding issues)
|
|
|
## [Documenting the configuration properties](Developer's-corner/Configuration-Properties-Documentation)
|
|
```
|
|
|
We tried to make as easy as possible.
|
|
source ./contrib/build/AdAstra/cpu-cray.sh
|
|
|
|
|
```
|
|
|
## [Configuration Checks](Developer's-corner/Configuration-Checks)
|
|
make the build dir. I use (cpu|gpu)/(par/seq)/(<compiler>)/(rel/dbg)
|
|
|
How to add configuration consistency tests.
|
|
encoding, but that personnal convenience.
|
|
|
|
|
|
|
|
|
|
```
|
|
|
## [Profiling](Developer's-corner/Profiling)
|
|
mkdir -p cpu/par/cray/rel
|
|
|
Where are we spending time.
|
|
cd cpu/par/cray/rel
|
|
|
|
|
Configure
|
|
|
## [Disk format evolution](Developer's-corner/Disk-format-evolution)
|
|
cmake -G Ninja -C ../../../../contrib/build/AdAstra/CRAY-CPU-cache.txt -DCMAKE_BUILD_TYPE=Release -DENABLE_PARALLEL=ON -DGENERATE_DOC=Off ../../../../
|
|
|
Sometime we change stuff and legacy disk files needs to be updated
|
|
|
|
|
|
|
```
|
|
|
## [Reference Manual](https://disc.pages.oca.eu/fargOCA/public/doxy)
|
|
to avoid conflicting with running test, BUT DO NOT USE IF YOU HAVE PRODUCTION JOBS RUNNING and remove specifically the test runs.
|
|
|
* [Main](https://disc.pages.oca.eu/fargOCA/public/doxy)
|
|
|
|
|
* [Namespace](https://disc.pages.oca.eu/fargOCA/public/doxy/namespaces.html)
|
|
```
|
|
|
* [Classes](https://disc.pages.oca.eu/fargOCA/public/doxy/annotated.html)
|
|
scancel -u alainm
|
|
|
|
|
|
|
|
ninja
|
|
|
|
```
|
|
|
|
|
|
|
|
run test on master to check we start with a clean situation
|
|
|
|
most of our clusters have a test script (jzTest.sh for Jean Zay, licTest.sh for licallo)
|
|
|
|
|
|
|
|
```
|
|
|
|
./contrib/dev/aaTest.sh
|
|
|
|
Passed 58 tests and failed 0 out of 58.
|
|
|
|
Test suite PASSED
|
|
|
|
|
|
|
|
If yout checked the branch already you do not need to check it again, go to the merge command:
|
|
|
|
|
|
|
|
```
|
|
|
|
git checkout 816-testing-streaming-instability
|
|
|
|
git merge master
|
|
|
|
```
|
|
|
|
|
|
|
|
FIX THIS
|
|
|
|
Auto-merging src/dustSpeciePlugin.cpp
|
|
|
|
CONFLICT (content): Merge conflict in src/dustSpeciePlugin.cpp
|
|
|
|
Automatic merge failed; fix conflicts and then commit the result.
|
|
|
|
|
|
|
|
```
|
|
|
|
ninja
|
|
|
|
./contrib/dev/aaTest.sh
|
|
|
|
Passed 58 tests and failed 0 out of 58.
|
|
|
|
```
|
|
|
|
|
|
|
|
Test suite PASSED you should have this
|
|
|
|
|
|
|
|
```
|
|
|
|
git checkout master
|
|
|
|
git merge 816-testing-streaming-instability
|
|
|
|
ninja
|
|
|
|
./contrib/dev/aaTest.sh
|
|
|
|
```
|
|
|
|
|
|
|
|
IF IT PASSES:
|
|
|
|
|
|
|
|
```
|
|
|
|
git push
|
|
|
|
|
|
|
|
```
|
|
|
|
### [Profiling with Extrae](Developer's-corner/Profiling with Extrae)
|
|
|
|
|
|
|
|
|
|
|
|
## Extending the code
|
|
|
|
### [Boundary Conditions](Developer's-corner/Boundary-Conditions)
|
|
|
|
How to add your own boundaries conditions.
|
|
|
|
### [Simulation Trackers](Developer's-corner/Simulation-Trackers)
|
|
|
|
How to add new simulation information gatherers, data extractors, surveillance etc..
|
|
|
|
|
|
|
|
## [Documenting the configuration properties](Developer's-corner/Configuration-Properties-Documentation)
|
|
|
|
We tried to make as easy as possible.
|
|
|
|
|
|
|
|
## [Configuration Checks](Developer's-corner/Configuration-Checks)
|
|
|
|
How to add configuration consistency tests.
|
|
|
|
|
|
|
|
|
|
|
|
## [Profiling](Developer's-corner/Profiling)
|
|
|
|
Where are we spending time.
|
|
|
|
|
|
|
|
## [Disk format evolution](Developer's-corner/Disk-format-evolution)
|
|
|
|
Sometime we change stuff and legacy disk files needs to be updated
|
|
|
|
|
|
|
|
## [Reference Manual](https://disc.pages.oca.eu/fargOCA/public/doxy)
|
|
|
|
* [Main](https://disc.pages.oca.eu/fargOCA/public/doxy)
|
|
|
|
* [Namespace](https://disc.pages.oca.eu/fargOCA/public/doxy/namespaces.html)
|
|
|
|
* [Classes](https://disc.pages.oca.eu/fargOCA/public/doxy/annotated.html)
|
|
|
* [Files](https://disc.pages.oca.eu/fargOCA/public/doxy/files.html) |
|
* [Files](https://disc.pages.oca.eu/fargOCA/public/doxy/files.html) |
|
|
|
\ No newline at end of file |
