examples.md
... ...
@@ -8,4 +8,5 @@ The following pages provide usage info and examples for select applications in t
8 8
- [Local Reconstruction in SCIPION](examples/localrec_w_scipion)
9 9
- [Locscale](examples/locscale)
10 10
- [PHENIX - phenix.rosetta_refine](examples/phenix.rosetta_refine)
11
- - [SCIPION - running tutorials without write privileges](examples/running_scipion_tutorials)
... ...
\ No newline at end of file
0
+ - [SCIPION - running tutorials without write privileges](examples/running_scipion_tutorials)
1
+ - [DIALS - Version control in DIALS](examples/DIALS_version_control)
... ...
\ No newline at end of file
examples/DIALS_version_control.md
... ...
@@ -0,0 +1,34 @@
1
+## Version control in DIALS
2
+Programs of the DIALS suite are provided by DIALS, ccp4, and phenix. Currently the default DIALS suite is provided by phenix, regardless of whether you have standalone DIALS installed. As the versions provided by standalone DIALS and DIALS bundled with other software suites can differ, you may want to switch the default DIALS executables to a different source.
3
+
4
+There are two main ways to do this, transient and persistent.
5
+
6
+### Transient way
7
+
8
+For example, if you want to process your X-ray dataset once with the newest xia2, but want to leave the default SBGrid behavior untouched, you can call xia2 and tell SBGrid to use the DIALS version (using --sbapp:a dials) like this:
9
+
10
+`xia2 --sbapp:a dials pipeline=dials /path/to/your/data`
11
+
12
+### Persistent way
13
+
14
+However, if you want to process your dataset step-by-step using the newest DIALS version, it may be more comfortable to set DIALS as the default source of all dials.*** executables.
15
+
16
+To do this, do
17
+```
18
+mkdir ~/.sbgrid_capsule
19
+cd ~/.sbgrid_capsule
20
+sbgrid-list dials |grep dials > list
21
+for each in $(cat list); do echo dials > $each; done
22
+rm list
23
+```
24
+Now all programs provided by dials that have 'dials' in their name will be called by default from the DIALS suite. Note that to use xia2 from DIALS, you will need to repeat the same steps selecting for binaries that contain 'xia2', like:
25
+
26
+```
27
+cd ~/.sbgrid_capsule
28
+sbgrid-list dials |grep xia2 > list
29
+for each in $(cat list); do echo dials > $each; done
30
+rm list
31
+```
32
+To reset your configuration, simply delete the files in the ~/.sbgrid_capsule directory
33
+
34
+Additional information on version control in SBGrid is provided here: https://sbgrid.org/wiki/capsules
... ...
\ No newline at end of file