how-to-add-the-llsw-model-to-basf.md

@@ -4,9 +4,45 @@ The LLSW model can be found in the DESY stash:
 `https://stash.desy.de/projects/B2/repos/software/browse/generators/evtgen/models/src/EvtLLSW.cc`
 
 In total there are four files needed: 
-* EvtLLSW.cc plus header file. 
-* EvtLLSWFF.cc plus header file.
+* `EvtLLSW.cc` plus header file. 
+* `EvtLLSWFF.cc` plus header file.
 
 The FF files contain the form factors for the decays.
 
+## How to compile and use the new model
+>>>
+Here is how to compile the existent module.
+( I'm not sure, but some people use basf2 evtgen to run evtgen,
+so there might be another way )
+1) make some working directory (e.g. ~/work )
+2) create a directory `~/work/belle/src` and go there
+3) execute following commands
+```
+source /sw/belle/local/etc/bashrc_general
+get_packages MODULE
+make -f Makefile.init
+make
+```
+then .so file will be under `~/work/belle/lib/so`
+In your case, MODULE above should be belleEvtGenModels etc.
+Now, one possible problem is that the compile in 3) might fail.
+In this case, the source code taken with get_packages commands
+are probably old (not compatible in SL6), and you need to manually
+copy them from `$BELLE_TOP_DIR` .
+Once you can compile the .so file, then you can run basf with
+your local .so files as below (replace v0finder below with your module)
+
+You need to put the directory that contains the local `v0finder.so` file
+inside `BASF_MODULE_DIR`. Suppose your v0finder.so is under `~/work/belle/bin`,
+you should do
+  `setenv BASF_MODULE_DIR ~/work/belle/bin:BASF_MODULE_DIR`
+inside your script after loading cshrc_general .
+Another way is to set `MY_TOP_DIR` to `~/work/belle` and do
+`source /sw/belle/local/etc/cshrc_general`
+. This should set `BASF_MODULE_DIR` correctly.
+Yet another way is to put your local `v0finder.so` inside your current
+directory. By default, current directory is at the top of `BASF_MODULE_DIR`
+`cw07:~$ echo $BASF_MODULE_DIR`
+>>>
+