From 41c35b6a6399a60f24c7021a8a36ac5df2fd7514 Mon Sep 17 00:00:00 2001 From: Christoph Ruegg Date: Wed, 22 Jan 2014 10:54:36 +0100 Subject: [PATCH] Docs: distance metric contour plots --- build.sh | 2 +- docs/content/Distance.fsx | 65 ++++++++++++++++++++++---- docs/files/img/DistanceCanberra.png | Bin 0 -> 11444 bytes docs/files/img/DistanceChebyshev.png | Bin 0 -> 9000 bytes docs/files/img/DistanceCosine.png | Bin 0 -> 3591 bytes docs/files/img/DistanceEuclidean.png | Bin 0 -> 11198 bytes docs/files/img/DistanceMAE.png | Bin 0 -> 12631 bytes docs/files/img/DistanceMSE.png | Bin 0 -> 13185 bytes docs/files/img/DistanceManhattan.png | Bin 0 -> 11552 bytes docs/files/img/DistanceMinkowski3.png | Bin 0 -> 9695 bytes docs/files/img/DistancePearson.png | Bin 0 -> 3838 bytes docs/files/img/DistanceSAD.png | Bin 0 -> 11552 bytes docs/files/img/DistanceSSD.png | Bin 0 -> 13169 bytes docs/tools/templates/template.cshtml | 2 +- 14 files changed, 57 insertions(+), 12 deletions(-) create mode 100644 docs/files/img/DistanceCanberra.png create mode 100644 docs/files/img/DistanceChebyshev.png create mode 100644 docs/files/img/DistanceCosine.png create mode 100644 docs/files/img/DistanceEuclidean.png create mode 100644 docs/files/img/DistanceMAE.png create mode 100644 docs/files/img/DistanceMSE.png create mode 100644 docs/files/img/DistanceManhattan.png create mode 100644 docs/files/img/DistanceMinkowski3.png create mode 100644 docs/files/img/DistancePearson.png create mode 100644 docs/files/img/DistanceSAD.png create mode 100644 docs/files/img/DistanceSSD.png diff --git a/build.sh b/build.sh index 8d4f1b86..dc013c46 100644 --- a/build.sh +++ b/build.sh @@ -1,5 +1,5 @@ #!/bin/bash if [ ! -f packages/FAKE/tools/Fake.exe ]; then - mono .NuGet/NuGet.exe install FAKE -OutputDirectory packages -ExcludeVersion + mono .nuget/nuget.exe install FAKE -OutputDirectory packages -ExcludeVersion fi mono packages/FAKE/tools/FAKE.exe build.fsx $@ diff --git a/docs/content/Distance.fsx b/docs/content/Distance.fsx index 7fbd8549..02ebf190 100644 --- a/docs/content/Distance.fsx +++ b/docs/content/Distance.fsx @@ -23,6 +23,8 @@ Math.NET Numerics provides the following distance functions on vectors and array Sum of Absolute Difference (SAD) -------------------------------- + + The sum of absolute difference is equivalent to the $L_1$-norm of the difference, also known as Manhattan- or Taxicab-norm. The `abs` function makes this metric a bit complicated to deal with analytically, but it is more robust than SSD. @@ -36,7 +38,10 @@ d_{\mathbf{SAD}} : (x, y) \mapsto \|x-y\|_1 = \sum_{i=1}^{n} |x_i-y_i| Sum of Squared Difference (SSD) ------------------------------- + + The sum of squared difference is equivalent to the squared $L_2$-norm, also known as Euclidean norm. +It is therefore also known as Squared Euclidean distance. This is the fundamental metric in least squares problems and linear algebra. The absence of the `abs` function makes this metric convenient to deal with analytically, but the squares cause it to be very sensitive to large outliers. @@ -51,7 +56,9 @@ d_{\mathbf{SSD}} : (x, y) \mapsto \|x-y\|_2^2 = \langle x-y, x-y\rangle = \sum_{ Mean-Absolute Error (MAE) ------------------------- -The mean absolute error is a normalized version of the sum of absolute difference: + + +The mean absolute error is a normalized version of the sum of absolute difference. $$$ d_{\mathbf{MAE}} : (x, y) \mapsto \frac{d_{\mathbf{SAD}}}{n} = \frac{\|x-y\|_1}{n} = \frac{1}{n}\sum_{i=1}^{n} |x_i-y_i| @@ -63,7 +70,9 @@ d_{\mathbf{MAE}} : (x, y) \mapsto \frac{d_{\mathbf{SAD}}}{n} = \frac{\|x-y\|_1}{ Mean-Squared Error (MSE) ------------------------ -The mean squared error is a normalized version of the sum of squared difference: + + +The mean squared error is a normalized version of the sum of squared difference. $$$ d_{\mathbf{MSE}} : (x, y) \mapsto \frac{d_{\mathbf{SSD}}}{n} = \frac{\|x-y\|_2^2}{n} = \frac{1}{n}\sum_{i=1}^{n} (x_i-y_i)^2 @@ -75,7 +84,10 @@ d_{\mathbf{MSE}} : (x, y) \mapsto \frac{d_{\mathbf{SSD}}}{n} = \frac{\|x-y\|_2^2 Euclidean Distance ------------------ -The euclidean distance is the $L_2$-norm of the difference: + + +The euclidean distance is the $L_2$-norm of the difference, a special case of the Minkowski distance with p=2. +It is the natural distance in a geometric interpretation. $$$ d_{\mathbf{2}} : (x, y) \mapsto \|x-y\|_2 = \sqrt{d_{\mathbf{SSD}}} = \sqrt{\sum_{i=1}^{n} (x_i-y_i)^2} @@ -87,7 +99,10 @@ d_{\mathbf{2}} : (x, y) \mapsto \|x-y\|_2 = \sqrt{d_{\mathbf{SSD}}} = \sqrt{\sum Manhattan Distance ------------------ -The manhattan distance is the $L_1$-norm of the difference and equivalent to the sum of absolute difference: + + +The manhattan distance is the $L_1$-norm of the difference, a special case of the Minkowski distance with p=1 +and equivalent to the sum of absolute difference. $$$ d_{\mathbf{1}} \equiv d_{\mathbf{SAD}} : (x, y) \mapsto \|x-y\|_1 = \sum_{i=1}^{n} |x_i-y_i| @@ -99,10 +114,13 @@ d_{\mathbf{1}} \equiv d_{\mathbf{SAD}} : (x, y) \mapsto \|x-y\|_1 = \sum_{i=1}^{ Chebyshev Distance ------------------ -The chebyshev distance is the $L_\infty$-norm of the difference: + + +The chebyshev distance is the $L_\infty$-norm of the difference, a special case of the Minkowski distance +where p goes to infinity. It is also known as Chessboard distance. $$$ -d_{\mathbf{\infty}} : (x, y) \mapsto \|x-y\|_\infty = \lim_{k \rightarrow \infty}\bigg(\sum_{i=1}^{n} |x_i-y_i|^k\bigg)^\frac{1}{k} = \max_{i} |x_i-y_i| +d_{\mathbf{\infty}} : (x, y) \mapsto \|x-y\|_\infty = \lim_{p \rightarrow \infty}\bigg(\sum_{i=1}^{n} |x_i-y_i|^p\bigg)^\frac{1}{p} = \max_{i} |x_i-y_i| [lang=csharp] double d = Distance.Chebyshev(x, y); @@ -111,7 +129,10 @@ d_{\mathbf{\infty}} : (x, y) \mapsto \|x-y\|_\infty = \lim_{k \rightarrow \infty Minkowski Distance ------------------ -The minkovski distance is the generalized $L_p$-norm of the difference: + + +The minkovski distance is the generalized $L_p$-norm of the difference. +The contour plot on the left demonstrates the case of p=3. $$$ d_{\mathbf{p}} : (x, y) \mapsto \|x-y\|_p = \bigg(\sum_{i=1}^{n} |x_i-y_i|^p\bigg)^\frac{1}{p} @@ -123,19 +144,42 @@ d_{\mathbf{p}} : (x, y) \mapsto \|x-y\|_p = \bigg(\sum_{i=1}^{n} |x_i-y_i|^p\big Canberra Distance ----------------- -The canberra distance is a weighted version of the manhattan distance: + + +The Canberra distance is a weighted version of the manhattan distance, introduced and refined 1967 by Lance, Williams and Adkins. +It is often used for data scattered around an origin, as it is biased for measures around the origin and very sensitive for values close to zero. $$$ -d_{\mathbf{Canberra}} : (x, y) \mapsto \sum_{i=1}^{n} \frac{|x_i-y_i|}{|x_i|+|y_i|} +d_{\mathbf{CAD}} : (x, y) \mapsto \sum_{i=1}^{n} \frac{|x_i-y_i|}{|x_i|+|y_i|} [lang=csharp] double d = Distance.Canberra(x, y); +Cosine Distance (planned) +------------------------- + + + +The cosine distance contains the dot product scaled by the product of the Euclidean distances from the origin. +It represents the angular distance of two vectors while ignoring their scale. + +$$$ +d_{\mathbf{cos}} : (x, y) \mapsto 1-\frac{\langle x, y\rangle}{\|x\|_2\|y\|_2} = 1-\frac{\sum_{i=1}^{n} x_i y_i}{\sqrt{\sum_{i=1}^{n} x_i^2}\sqrt{\sum_{i=1}^{n} y_i^2}} + + [lang=csharp] + // Planned (not implemented yet): + double d = Distance.Cosine(x, y); + + Pearson's Distance ------------------ -The pearson's distance is based on pearson's product-momentum correlation coefficient of the two sample vectors: + + +The Pearson distance is a correlation distance based on Pearson's product-momentum correlation coefficient +of the two sample vectors. Since the correlation coefficient falls between [-1, 1], the Pearson distance +lies in [0, 2] and measures the linear relationship between the two vectors. $$$ d_{\mathbf{Pearson}} : (x, y) \mapsto 1 - \mathbf{Corr}(x, y) @@ -148,6 +192,7 @@ Hamming Distance ---------------- The hamming distance represents the number of entries in the two sample vectors which are different. +It is a fundamental distance measure in information theory but less relevant in non-integer numerical problems. [lang=csharp] double d = Distance.Hamming(x, y); diff --git a/docs/files/img/DistanceCanberra.png b/docs/files/img/DistanceCanberra.png new file mode 100644 index 0000000000000000000000000000000000000000..a1e3092034bdb77bf78c9931ec612d9a54b5e691 GIT binary patch literal 11444 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 N002ovPDHLkV1l%zr1Jm( literal 0 HcmV?d00001 diff --git a/docs/files/img/DistanceEuclidean.png b/docs/files/img/DistanceEuclidean.png new file mode 100644 index 0000000000000000000000000000000000000000..7aa858a5bbe8629cbb9f3e3cc560472c7a0389cd GIT binary patch literal 11198 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 literal 0 HcmV?d00001 diff --git a/docs/files/img/DistanceMAE.png b/docs/files/img/DistanceMAE.png new file mode 100644 index 0000000000000000000000000000000000000000..4423c49f052a63644681ed0cbf37c99055d7f093 GIT binary patch literal 12631 zcmV-dF{sXoP)G+<* zvZvWg7)5a`$}_9#?gs_F!@OGg?6m8u4N4y|%pg7>09A+FhAqGuQ_^vjP3Z{32ZVi0 z`XItm(j2h^&-stvdvU2?aST8!6JzN!hUpsjd&qv~T_ju&mPITJ#}LsP-`{+{#;HYH zCzO;-lZN#c#S1I(qBYNG93|%$)rz0ohM%L!R8z)cu?giEi%E2lXkE!lU(>k`0^4mJ zlhBs1^?vp_+{=iOT3iB{$dSu=#+k2b3i7 ztRqtgDq^+MPM1c7V^t>KIPzdUO&rU!hX%`XBLg{AI0BMB$B2C6)dU>N9Sl8pLj@?r z=6dTV1QtHx_x|(iTaewOwAT4kfTng?nrZn=8X`xz?}bdt92V4i2olI52$asS%us3~ zW8mfPnZfP(WAL($f0u{oAVrZ`qC~9rP%N6Pt@Z}#X}V9n2}+X!s{yM*rG~W&U3~7G zFdu6zrI-7|dWx%%;g~nN+9h*E=thNvwf|wq4G1cfc)gqcff)IK3#NXQR}a|mC*fRd zz62nf{Fajj!YKZ2vI)CT8XEqEO_P>FXIjxZzJNDAfUoDXIF1)y=;)>6*p}8(VUm`T zAcTJ*B&-{l&UEyC&+nXX&m8pe!@FV*pS29SfZIWEZ59RK^m#0ASVU& zeh+Q?6iWHtx9@Y5DBFl?y!?nsML|&g2Os!Wgz=N45z;UQt$_JptZjOkXdd|i5yWF z@9r6A7!c$pC<9`F23*jjG@5K}ZSu60KQ>kSn5R7CCE3)P)h%SXBnm-n1S1R=WiHH2 z=QN_5?7mPG%=dl2KGUa9+W0AF5cfl3q{Gy-Cq~H8r#*9^v-A4M1*+V=-oy%$>9xT6a7Ly7cn5x@B*hZ0U zBnv2}^2Y*cY?^e8)%Z%Oa@*A$g6u2!1I@Uewz>Z7lfretT ztomKr8*OKzK*94{jdCKka`N`PnDWxTnXo&|&ib+#VPz>mZN9^&VneSZ_*$WJGyjS*+-v&ca2Kzu52-O6!SOuyoQa zrg;5Q?ltFcSCLGnRb988yw`hN(SW5@{jhK`>;=oD<+y~v`b($Hy$uEUp?>_-f_%`| zbklLqD|ld9Tat48K})ZCKW8x~UBdM#oo)PjT#XoHfl?nWo^mIyE)58 zmpO~qD-qB`e$si&mw3M6I2TonMEBQUM!sb-yp%N4%1Fu|pSYNg-R~3nlt1U!>zp6- zc!_~NEKBcxzUMA&309Pq{>Op_e-VO6!nuUO(s_T35PSREtzo;p@eK4!B91~+!LJPc z^m+haw1y0y1)mQISdA#QC?H3?ydDx9-Db#9^SiV^IXVc{MtVH36j--rHrs#YgXz^9 z8Q;AMIyTPa8C)bhc`tGiOYVraLrGkgB?2QEN3(FBP;-0qcJllnR3GV4pX6V+?k8^H zrSkm`A!g%jjzQr(IRzPf`eR+cCUG_5J--?f-aMWq9Nl8X<}A09Zx2G1!E|-*V$TqB z2;?vHri+q!r0ZQ_Z9U>GH?_p(I`0wgqDVNh&9JNHIm?TqFtC7&60HMQd5jy; oikp{usgc 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 literal 0 HcmV?d00001 diff --git a/docs/files/img/DistanceManhattan.png b/docs/files/img/DistanceManhattan.png new file mode 100644 index 0000000000000000000000000000000000000000..0eff545df2dab8c293146ee277d9c718a1e2ea23 GIT binary patch literal 11552 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 SF0f(%0000 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 literal 0 HcmV?d00001 diff --git a/docs/files/img/DistancePearson.png b/docs/files/img/DistancePearson.png new file mode 100644 index 0000000000000000000000000000000000000000..67e2cbdcc14bbe6f15aac1827150af328e176093 GIT binary patch literal 3838 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 Av;Y7A literal 0 HcmV?d00001 diff --git a/docs/files/img/DistanceSAD.png b/docs/files/img/DistanceSAD.png new file mode 100644 index 0000000000000000000000000000000000000000..0eff545df2dab8c293146ee277d9c718a1e2ea23 GIT binary patch literal 11552 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 X${DLx&d_nZ00000NkvXXu0mjf%(s;{ literal 0 HcmV?d00001 diff --git a/docs/tools/templates/template.cshtml b/docs/tools/templates/template.cshtml index 2fad33da..473dabbe 100644 --- a/docs/tools/templates/template.cshtml +++ b/docs/tools/templates/template.cshtml @@ -54,7 +54,7 @@
  • API Reference (docu)
  • -
  • API Reference (new)
  • +
  • API Reference (new)