docs: table with vswf conventions

Former-commit-id: 0d8067466d3cfdae70b4a5e424a645c0b2febdd2

Doxyfile

@@ -682,7 +682,7 @@ LAYOUT_FILE            =
 # LATEX_BIB_STYLE. To use this feature you need bibtex and perl available in the
 # search path. See also \cite for info how to create references.
 
-CITE_BIB_FILES         =
+CITE_BIB_FILES         = notes/Electrodynamics.bib
 
 #---------------------------------------------------------------------------
 # Configuration options related to warning and progress messages
@@ -753,7 +753,7 @@ WARN_LOGFILE           =
 # spaces.
 # Note: If this tag is empty the current directory is searched.
 
-INPUT                  = qpms finite_systems.md README.md README.Triton.md finite_systems.md lattices.md TODO.md
+INPUT                  = qpms notes finite_systems.md README.md README.Triton.md finite_systems.md lattices.md TODO.md
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
@@ -1477,7 +1477,7 @@ MATHJAX_EXTENSIONS     =
 # example see the documentation.
 # This tag requires that the tag USE_MATHJAX is set to YES.
 
-MATHJAX_CODEFILE       =
+MATHJAX_CODEFILE       = notes/mathjax_newcommands.js
 
 # When the SEARCHENGINE tag is enabled doxygen will generate a search box for
 # the HTML output. The underlying search engine uses javascript and DHTML and

notes/conventions.md

@@ -0,0 +1,23 @@
+VSWF conventions
+================
+
+
+| Source	| VSWF definition  	| VSWF norm  	| CS Phase  	|  Field expansion 	|  Radiated power | Notes |
+|---	|---	|---	|---	|---	|---	|--- 	|
+| Kristensson I \cite kristensson_spherical_2014 	|  \f[ \wfkcreg, \wfkcout= \dots \f] 	|   	|   	| \f[ 
+	\vect E = k \sqrt{\eta_0\eta} \sum_n \left( \wckcreg_n  \wfkcreg_n + \wckcout_n \wfkcout_n  \right), 
+	\\ 
+	\vect H =  \frac{k \sqrt{\eta_0\eta}}{i\eta_0\eta} \sum_n \left( \wckcreg_n  \wfkcreg_n + \wckcout_n \wfkcout_n  \right)
+\f] 	| \f[
+	 P = \frac{1}{2} \sum_n \left( \abs{\wckcout_n}^2 +\Re \left(\wckcout_n\wckcreg_n^{*}\right)\right)
+ \f]	| The \f$ \wckcreg, \wckcout \f$	coefficients have dimension \f$ \sqrt{\mathrm{W}} \f$. |
+| Kristensson II \cite kristensson_scattering_2016	| \f[ \wfkrreg, \wfkrout= \dots \f] 	|   	|   	| \f[ 
+	\vect E = \sum_n \left( \wckrreg_n  \wfkrreg_n + \wckrout_n \wfkrout_n  \right), 
+	\\ 
+	\vect H =  \frac{1}{i\eta_0\eta} \sum_n \left( \wckrreg_n  \wfkrreg_n + \wckrout_n \wfkrout_n  \right)
+\f] 	| \f[
+	 P = \frac{1}{2k^2\eta_0\eta} \sum_n \left( \abs{\wckrout_n}^2 +\Re \left(\wckrout_n\wckrreg_n^{*}\right)\right)
+ \f]	| The \f$ \wckrreg, \wckrout \f$ coefficients have dimension \f$ \mathrm{V/m} \f$. |
+| Reid \cite reid_electromagnetism_2016	|   |  	|   	|   	| 	| 	|
+| Taylor \cite taylor_optical_2011	|   | 	|   	|   	| 	| Different sign for regular/scattered waves! |
+

notes/mathjax_newcommands.js

@@ -0,0 +1,32 @@
+MathJax.Hub.Config({
+    TeX: {
+        Macros: {
+            vect: ["{\\mathbf{#1}}",1],
+            abs: ["{\\left|{#1}\\right|}",1],
+            ud: "{\\mathrm{d}}",
+	    pr: ["{\\left({#1}\\right)}", 1], // parentheses to save typing
+            // Kristensson's VSWFs, complex version (2014 notes)
+            wfkcreg: "{\\vect{v}}", // regular wave
+            wfkcout: "{\\vect{u}}", // outgoing wave
+            wckcreg: "{a}", // regular wave coeff
+            wckcout: "{f}", // outgoing wave coeff
+            
+	    // Kristensson's VSWFs, real version (2014 book)
+            wfkrreg: "{\\vect{v}}", // regular wave
+            wfkrout: "{\\vect{u}}", // outgoing wave
+            wckrreg: "{a}", // regular wave coeff
+            wckrout: "{f}", // outgoing wave coeff
+
+	    // Taylor's VSWFs
+	    wfmtreg: "{\\widetilde{\\vect{M}}^{(1)}}", // regular magnetic wave
+	    wfetreg: "{\\widetilde{\\vect{N}}^{(1)}}", // regular electric wave
+	    wfmtout: "{\\widetilde{\\vect{M}}^{(3)}}", // outgoing magnetic wave
+	    wfetout: "{\\widetilde{\\vect{N}}^{(3)}}", // outgoing electric wave
+	    wcmtreg: "{q}", // regular magnetic wave coeff
+	    wcetreg: "{p}", // regular electric wave coeff
+	    wcmtout: "{b}", // outgoing magnetic wave coeff
+	    wcetout: "{a}" // outgoing electric wave coeff
+        }
+    }
+});
+