Migrating wiki contents from Google Code

Author: GoogleCodeExporter

CommandLineInterface.md

@@ -0,0 +1,20 @@
+You can use JMathPlot in CLI to plot the content of ASCII files (same way that XMGrace). You just need to get jplot.sh for Linux/MacOS/Solaris or jplot.bat for Windows, and jmathplot.jar in the same directory.
+```
+Usage: jplot.<sh|bat> <-2D|-3D> [-l <INVISIBLE|NORTH|SOUTH|EAST|WEST>] [options] <ASCII file (n rows, m columns)> [[options] other ASCII file]
+[-l <INVISIBLE|NORTH|SOUTH|EAST|WEST>] giving the legend position
+[options] are:
+  -t <SCATTER|LINE|BAR|HISTOGRAM2D(<integer h>)|HISTOGRAM3D(<integer h>,<integer k>)|GRID3D|CLOUD2D(<integer h>,<integer k>)|CLOUD3D(<integer h>,<integer k>,<integer l>)>    type of the plot
+      SCATTER|LINE|BAR: each line of the ASCII file contains coordinates of one point.
+      HISTOGRAM2D(<integer h>): ASCII file contains the 1D sample (i.e. m=1) to split in h slices.
+      HISTOGRAM3D(<integer h>,<integer k>): ASCII file contains the 2D sample (i.e. m=2) to split in h*k slices (h slices on X axis and k slices on Y axis).
+      GRID3D: ASCII file is a matrix, first row gives n X grid values, first column gives m Y grid values, other values are Z values.
+      CLOUD2D(<integer h>,<integer k>): ASCII file contains the 2D sample (i.e. m=2) to split in h*k slices (h slices on X axis and k slices on Y axis), density of cloud corresponds to frequency of X-Y slice in given 2D sample.
+      CLOUD3D(<integer h>,<integer k>,<integer l>): ASCII file contains the 3D sample (i.e. m=3) to split in h*k*l slices (h slices on X axis, k slices on Y axis, l slices on Y axis), density of cloud corresponds to frequency of X-Y-Z slice in given 3D sample.
+  -n name    name of the plot
+  -v <ASCII file (n,3|2)>    vector data to add to the plot
+  -q<X|Y|Z>(<float Q>) <ASCII file (n,1)>    Q-quantile to add to the plot on <X|Y|Z> axis. Each line of the given ASCII file contains the value of quantile for probvability Q.
+  -qP<X|Y|Z> <ASCII file (n,p)>    p-quantiles density to add to the plot on <X|Y|Z> axis. Each line of the given ASCII file contains p values.
+  -qN<X|Y|Z> <ASCII file (n,1)>    Gaussian density to add to the plot on <X|Y|Z> axis. Each line of the given ASCII file contains a standard deviation.
+
+Example: jplot.<sh|bat> -3D -l SOUTH -t SCATTER tmp.dat
+```

CustomPlotExample.md

@@ -0,0 +1,63 @@
+
+```
+import java.awt.*;
+ 
+import javax.swing.*;
+ 
+import org.math.plot.*;
+import org.math.plot.plotObjects.*;
+ 
+import static java.lang.Math.*;
+ 
+import static org.math.array.StatisticSample.*;
+ 
+public class CustomPlotExample {
+	public static void main(String[] args) {
+ 
+		// define your data
+		double[] x = randomNormal(1000, 0, 1); // 1000 random numbers from a normal (Gaussian) statistical law
+		double[] y = randomUniform(1000, -3, 3); // 1000 random numbers from a uniform statistical law
+ 
+		// create your PlotPanel (you can use it as a JPanel)
+		Plot2DPanel plot = new Plot2DPanel();
+ 
+		// legend at SOUTH
+		plot.addLegend("SOUTH");
+ 
+		// add the histogram (50 slices) of x to the PlotPanel
+		plot.addHistogramPlot("Gaussian population", x, 50);
+ 
+		// add the histogram (50 slices) of y to the PlotPanel in GREEN
+		plot.addHistogramPlot("Uniform population", Color.RED, y, 50);
+ 
+		// add a title
+		BaseLabel title = new BaseLabel("...My nice plot...", Color.RED, 0.5, 1.1);
+		title.setFont(new Font("Courier", Font.BOLD, 20));
+		plot.addPlotable(title);
+ 
+		// change name of axes
+		plot.setAxesLabels("<X>", "frequency");
+ 
+		// customize X axe
+		// rotate light labels
+		plot.getAxe(0).setLightLabelAngle(-PI / 4);
+		// change axe title position relatively to the base of the plot
+		plot.getAxe(0).setLabelPosition(0.5, -0.15);
+ 
+		// customize Y axe
+		// rotate light labels
+		plot.getAxe(1).setLightLabelAngle(-PI / 4);
+		// change axe title position relatively to the base of the plot
+		plot.getAxe(1).setLabelPosition(-0.15, 0.5);
+		// change axe title angle
+		plot.getAxe(1).setLabelAngle(-PI / 2);
+ 
+		// put the PlotPanel in a JFrame like a JPanel
+		JFrame frame = new JFrame("a plot panel");
+		frame.setSize(600, 600);
+		frame.setContentPane(plot);
+		frame.setVisible(true);
+ 
+	}
+}
+```

GridPlotsExample.md

@@ -0,0 +1,65 @@
+
+```
+import javax.swing.*;
+ 
+import org.math.plot.*;
+ 
+import static java.lang.Math.*;
+ 
+import static org.math.array.DoubleArray.*;
+ 
+public class GridPlotsExample {
+	public static void main(String[] args) {
+ 
+		// define your data
+		double[] x = increment(0.0, 0.1, 1.0); // x = 0.0:0.1:1.0
+		double[] y = increment(0.0, 0.05, 1.0);// y = 0.0:0.05:1.0
+		double[][] z1 = f1(x, y);
+		double[][] z2 = f2(x, y);
+ 
+		// create your PlotPanel (you can use it as a JPanel) with a legend at SOUTH
+		Plot3DPanel plot = new Plot3DPanel("SOUTH");
+ 
+		// add grid plot to the PlotPanel
+		plot.addGridPlot("z=cos(PI*x)*sin(PI*y)", x, y, z1);
+		plot.addGridPlot("z=sin(PI*x)*cos(PI*y)", x, y, z2);
+ 
+		// put the PlotPanel in a JFrame like a JPanel
+		JFrame frame = new JFrame("a plot panel");
+		frame.setSize(600, 600);
+		frame.setContentPane(plot);
+		frame.setVisible(true);
+ 
+	}
+ 
+	// function definition: z=cos(PI*x)*sin(PI*y)
+	public static double f1(double x, double y) {
+		double z = cos(x * PI) * sin(y * PI);
+		return z;
+	}
+ 
+	// grid version of the function
+	public static double[][] f1(double[] x, double[] y) {
+		double[][] z = new double[y.length][x.length];
+		for (int i = 0; i < x.length; i++)
+			for (int j = 0; j < y.length; j++)
+				z[j][i] = f1(x[i], y[j]);
+		return z;
+	}
+ 
+	// another function definition: z=sin(PI*x)*cos(PI*y)
+	public static double f2(double x, double y) {
+		double z = sin(x * PI) * cos(y * PI);
+		return z;
+	}
+ 
+	// grid version of the function
+	public static double[][] f2(double[] x, double[] y) {
+		double[][] z = new double[y.length][x.length];
+		for (int i = 0; i < x.length; i++)
+			for (int j = 0; j < y.length; j++)
+				z[j][i] = f2(x[i], y[j]);
+		return z;
+	}
+}
+```

HistogramExample.md

@@ -0,0 +1,29 @@
+
+```
+import javax.swing.*;
+ 
+import org.math.plot.*;
+ 
+import static org.math.array.StatisticSample.*;
+ 
+public class HistogramExample {
+	public static void main(String[] args) {
+ 
+		// define your data
+		double[] x = randomLogNormal(1000, 0, 0.5); // 1000 random numbers from a log normal statistical law
+ 
+		// create your PlotPanel (you can use it as a JPanel)
+		Plot2DPanel plot = new Plot2DPanel();
+ 
+		// add the histogram (50 slices) of x to the PlotPanel
+		plot.addHistogramPlot("Log Normal population", x, 50);
+ 
+		// put the PlotPanel in a JFrame like a JPanel
+		JFrame frame = new JFrame("a plot panel");
+		frame.setSize(600, 600);
+		frame.setContentPane(plot);
+		frame.setVisible(true);
+ 
+	}
+}
+```

LinePlotExample.md

@@ -0,0 +1,31 @@
+
+```
+import javax.swing.*;
+ 
+import org.math.plot.*;
+ 
+public class LinePlotExample {
+	public static void main(String[] args) {
+ 
+		// define your data
+		double[] x = { 1, 2, 3, 4, 5, 6 };
+		double[] y = { 45, 89, 6, 32, 63, 12 };
+ 
+		// create your PlotPanel (you can use it as a JPanel)
+		Plot2DPanel plot = new Plot2DPanel();
+ 
+		// define the legend position
+		plot.addLegend("SOUTH");
+ 
+		// add a line plot to the PlotPanel
+		plot.addLinePlot("my plot", x, y);
+ 
+		// put the PlotPanel in a JFrame like a JPanel
+		JFrame frame = new JFrame("a plot panel");
+		frame.setSize(600, 600);
+		frame.setContentPane(plot);
+		frame.setVisible(true);
+ 
+	}
+}
+```

ProjectHome.md

@@ -0,0 +1,39 @@
+| **Professional support is now available at https://sites.google.com/site/mulabsltd/products/jmathplot**|
+|:|
+
+# JMathPlot: interactive 2D and 3D plots #
+Provides interactive 2D/3D plot (without openGL) :
+  * 2D/3D scatter plot
+  * 2D/3D line plot
+  * 2D staircase plot
+  * 2D/3D histogram plot
+  * 2D/3D boxplot
+  * 3D grid plot
+  * 2D/3D quantiles on plots
+
+**_Note: for a true OpenGL java plot library, try the good [jzy3d](http://code.google.com/p/jzy3d) project_**
+
+# Example Java code #
+```
+import org.math.plot.*;
+...
+  
+  double[] x = ...
+  double[] y = ...
+ 
+  // create your PlotPanel (you can use it as a JPanel)
+  Plot2DPanel plot = new Plot2DPanel();
+ 
+  // add a line plot to the PlotPanel
+  plot.addLinePlot("my plot", x, y);
+ 
+  // put the PlotPanel in a JFrame, as a JPanel
+  JFrame frame = new JFrame("a plot panel");
+  frame.setContentPane(plot);
+  frame.setVisible(true);
+```
+# Use it #
+  1. put [jmathplot.jar](http://jmathplot.googlecode.com/svn/trunk/jmathplot/dist/jmathplot.jar) in your java classpath
+  1. create a new PlotPanel instance: `Plot2DPanel plot = new Plot2DPanel();`
+  1. add a plot inside `plot.addLinePlot("my plot", x, y);`
+  1. use the PlotPanel as any Swing component (all PlotPanel extends JPanel, in fact)

Python.md

@@ -0,0 +1,17 @@
+
+```
+Usage : jplot2d(data1,options,data2,options) or jplot3d(data1,options,data2,options) [data] is an array of numbers, [options] are related to previous [data] and should be :
+
+ -t <SCATTER|LINE|BAR|HISTOGRAM2D(<integer h>)|HISTOGRAM3D(<integer h>,<integer k>)|GRID3D|CLOUD2D(<integer h>,<integer k>)|CLOUD3D(<integer h>,<integer k>,<integer l>)>    type of the plot
+      SCATTER|LINE|BAR: each line of the ASCII file contains coordinates of one point.
+      HISTOGRAM2D(<integer h>): ASCII file contains the 1D sample (i.e. m=1) to split in h slices.
+      HISTOGRAM3D(<integer h>,<integer k>): ASCII file contains the 2D sample (i.e. m=2) to split in h*k slices (h slices on X axis and k slices on Y axis).
+      GRID3D: ASCII file is a matrix, first row gives n X grid values, first column gives m Y grid values, other values are Z values.
+      CLOUD2D(<integer h>,<integer k>): ASCII file contains the 2D sample (i.e. m=2) to split in h*k slices (h slices on X axis and k slices on Y axis), density of cloud corresponds to frequency of X-Y slice in given 2D sample.
+      CLOUD3D(<integer h>,<integer k>,<integer l>): ASCII file contains the 3D sample (i.e. m=3) to split in h*k*l slices (h slices on X axis, k slices on Y axis, l slices on Y axis), density of cloud corresponds to frequency of X-Y-Z slice in given 3D sample.
+  -n name    name of the plot
+  -v <ASCII file (n,3|2)>    vector data to add to the plot
+  -q<X|Y|Z>(<float Q>) <ASCII file (n,1)>    Q-quantile to add to the plot on <X|Y|Z> axis. Each line of the given ASCII file contains the value of quantile for probvability Q.
+  -qP<X|Y|Z> <ASCII file (n,p)>    p-quantiles density to add to the plot on <X|Y|Z> axis. Each line of the given ASCII file contains p values.
+  -qN<X|Y|Z> <ASCII file (n,1)>    Gaussian density to add to the plot on <X|Y|Z> axis. Each line of the given ASCII file contains a standard deviation.
+```

Scilab.md

@@ -0,0 +1,17 @@
+
+```
+Usage : jplot2d(data1,options,data2,options) or jplot3d(data1,options,data2,options) [data] is an array of numbers, [options] are related to previous [data] and should be :
+
+ -t <SCATTER|LINE|BAR|HISTOGRAM2D(<integer h>)|HISTOGRAM3D(<integer h>,<integer k>)|GRID3D|CLOUD2D(<integer h>,<integer k>)|CLOUD3D(<integer h>,<integer k>,<integer l>)>    type of the plot
+      SCATTER|LINE|BAR: each line of the ASCII file contains coordinates of one point.
+      HISTOGRAM2D(<integer h>): ASCII file contains the 1D sample (i.e. m=1) to split in h slices.
+      HISTOGRAM3D(<integer h>,<integer k>): ASCII file contains the 2D sample (i.e. m=2) to split in h*k slices (h slices on X axis and k slices on Y axis).
+      GRID3D: ASCII file is a matrix, first row gives n X grid values, first column gives m Y grid values, other values are Z values.
+      CLOUD2D(<integer h>,<integer k>): ASCII file contains the 2D sample (i.e. m=2) to split in h*k slices (h slices on X axis and k slices on Y axis), density of cloud corresponds to frequency of X-Y slice in given 2D sample.
+      CLOUD3D(<integer h>,<integer k>,<integer l>): ASCII file contains the 3D sample (i.e. m=3) to split in h*k*l slices (h slices on X axis, k slices on Y axis, l slices on Y axis), density of cloud corresponds to frequency of X-Y-Z slice in given 3D sample.
+  -n name    name of the plot
+  -v <ASCII file (n,3|2)>    vector data to add to the plot
+  -q<X|Y|Z>(<float Q>) <ASCII file (n,1)>    Q-quantile to add to the plot on <X|Y|Z> axis. Each line of the given ASCII file contains the value of quantile for probvability Q.
+  -qP<X|Y|Z> <ASCII file (n,p)>    p-quantiles density to add to the plot on <X|Y|Z> axis. Each line of the given ASCII file contains p values.
+  -qN<X|Y|Z> <ASCII file (n,1)>    Gaussian density to add to the plot on <X|Y|Z> axis. Each line of the given ASCII file contains a standard deviation.
+```