Helmholtz-decomposition-code.md

-TODO
+
\ No newline at end of file
+# Introduction
+Info about theory. Link to Tsubota paper...
+
+# Usage
+TODO: explain how to use...
+```bash
+[gabrielw@node2066 tmp]$ mpirun -np 5 wslda-hdc-3d test2.wtxt 0          
+
+         Adding new variables [wc_a, wi_a] to w-data set.
+         Number of measurements = 10
+         Starting time          = -1 
+         Lattice size   = 80 x 80 x 16 
+         Ending time            = 9.000 
+         Component = a 
+         Variables being produced = wi_a & wc_a 
+         Creating file: test2_hh_a.txt
+         Creating file: test2_hhspec_a.txt
+
+         Reading frame [1], currently at 1%
+         ....
+        Completed in    4s ( 0m 4s)! 
+```
+
+TODO: Explain what are output files... their meaning and content, in what units are columns
+
+# Limitations
+Presently the code supports only 3d data. However, you can apply it to 2D as well, but before that, you need to increase data dimensionality. You can do it using wdata tool `wdata-datadim-up`. For example:
+```bash
+[gabrielw@node2066 tmp]$ wdata-datadim-up test1.wtxt test2 3
+# WDATA TOOL: DATADIM MODIFIER
+# READING INPUT DATA: `test1.wtxt`
+# ************************ LATTICE ***************************
+# LATTICE: 80 x 80 x 16
+# SPACING: 1.000000 x 1.000000 x 1.000000
+# VOLUME : 80.000000 x 80.000000 x 16.000000
+# DIM-IN : 2
+# DIM-OUT: 3
+# RESIZING `rho_a`...
+# RESIZING `rho_b`...
+# RESIZING `delta`...
+# RESIZING `j_a`...
+# RESIZING `j_b`...
+# RESIZING `nu`...
+# RESIZING `tau_a`...
+# RESIZING `tau_b`...
+# RESIZING `V_a`...
+# RESIZING `V_b`...
+# RESIZING `V_ext_a`...
+# RESIZING `V_ext_b`...
+# RESIZING `delta_ext`...
+# RESIZING `velocity_ext_a`...
+# RESIZING `velocity_ext_b`...
+# RESIZING `alpha_a`...
+# RESIZING `alpha_b`...
+# RESIZING `A_a`...
+# RESIZING `A_b`...
+# WRITING `test2.wtxt`
+# DONE.
+```
+
+# Developers
+* Andrea Barresi, Warsaw University of Technology