adjust documentation

docs/source/calibrator.rst

@@ -278,7 +278,7 @@ A comprehensive explanation of the baseline selection syntax can be found `here`
 
 - ``max_dppp_threads``: number of threads per process for DP3 (default: 10)
 - ``memoryperc``: maximum of memory used for aoflagger in raw_flagging mode in percent (default: 20)
-- ``aoflag_reorder``: will reorder the measurement set before running aoflagger
+- ``aoflag_reorder``: make aoflagger reorder the measurement set before running the detection. This prevents that aoflagger will use its memory reading mode, which is faster but uses more memory (see the `AOFlagger manual`_`)
 
 **Parameters you may want to adjust**
 
@@ -296,3 +296,4 @@ A comprehensive explanation of the baseline selection syntax can be found `here`
 
 .. _here: https://www.astron.nl/lofarwiki/doku.php?id=public:user_software:documentation:ndppp#description_of_baseline_selection_parameters
 .. _AOFlagger: https://gitlab.com/aroffringa/aoflagger.git
+.. _AOFlagger manual: https://aoflagger.readthedocs.io/en/latest/using_aoflagger.html
\ No newline at end of file

docs/source/target.rst

@@ -303,7 +303,7 @@ A comprehensive explanation of the baseline selection syntax can be found `here`
 
 - ``max_dppp_threads``: number of threads per process for DP3 (default: 10)
 - ``memoryperc``: maximum of memory used for aoflagger in raw_flagging mode in percent (default: 20)
-- ``aoflag_reorder``: will reorder the measurement set before running aoflagger
+- ``aoflag_reorder``: make aoflagger reorder the measurement set before running the detection. This prevents that aoflagger will use its memory reading mode, which is faster but uses more memory (see the `AOFlagger manual`_`)
 
 *Skymodel directory*
 
@@ -345,3 +345,4 @@ If your **LBA** data has **not** been demixed before you may still want to keep
 .. _Dysco: https://github.com/aroffringa/dysco/
 .. _AOFlagger: https://gitlab.com/aroffringa/aoflagger.git
 .. _here: https://www.astron.nl/lofarwiki/doku.php?id=public:user_software:documentation:ndppp#description_of_baseline_selection_parameters
+.. _AOFlagger manual: https://aoflagger.readthedocs.io/en/latest/using_aoflagger.html
\ No newline at end of file

steps/aoflag.cwl

@@ -54,8 +54,8 @@ inputs:
   - id: reorder
     type: boolean?
     doc: |
-      Will reorder the measurement set before starting, which is normally
-      faster but requires free disk space to reorder the data to.
+      Make aoflagger reorder the measurement set before running the detection.
+      This prevents that aoflagger will use its memory reading mode, which is faster but uses more memory.
     inputBinding:
       prefix: -reorder
       position: 0