diff --git a/README.md b/README.md index 767ddfe..ec5d029 100644 --- a/README.md +++ b/README.md @@ -1,43 +1,96 @@ # A Computer-aided Tool for Nelder Plot Design +Author: Degi Harja Asmara and Steve Cumming + ## Overview Nelder plot (Nelder 1962) is an experimental design for testing a multiple tree -spacings in a single plot. The shape of plot is circular with some number of concentric wheels or arcs radiating outward and the spokes connecting the center. The intersections of spokes and arcs are the tree positions. The tree position on different wheels represent a different the tree spacing distance or tree density. This design eliminates the need for separate experimental plots for each tree density. The difficulties with Nelder plot design is their uncommon layout and complex parameterization (Parrott et al. 2012). A computer-aided tool for designing the Nelder plot can be very useful for the practical implementation of this experimental design. +spacings in a single plot. The shape of plot is circular with some number of concentric wheels or arcs radiating outward and the spokes connecting the center. The intersections of spokes and arcs are the tree positions. The tree position on different wheels represent a different the tree spacing distance or tree density. This design eliminates the need for separate experimental plots for each tree density. The difficulties with Nelder plot design is their uncommon layout and complex parameterization (Parrott et al. 2012). This computer-aided tool for designing the Nelder plot can be very useful for the practical implementation of this experimental design. + +The binary distribution of this software can be found at: + + +The source code location: + ## Software Specification +The software is designed to be used by either forestry practitioner or those who one to explore the Nelder plot parameterization. Two type of input parameters option is available: practical and standard parametrization. The plot design will be automatically displayed as soon as the required parameters are satisfied. + ### Input #### Practical Parameters -* Minimum planting density -* Maximum planting density +* Minimum planting density (trees/ha) +* Maximum planting density (trees/ha) * Number of density range -* Rectangularity +* Rectangularity (1 - for 'square' approximation) #### Standard Parameters * Plot dimension (Width, Height) * Initial radius (r_0) -* Constant increment of arcs radius (α) +* Arcs radius rate of change (α) * Division angle of spokes (θ) #### Additional Parameters * Center of rotation (x, y) -* Number of Species +* Number of Species (max 3) ### Output -* Plot design -* Individual position coordinates and variables +The software provides various output including: + +* Text file with all the parameters, plot variables and data points +* Plot design that can be exported into various image format +* KML file which includes individual plant position coordinates and plot design information + +Below are some screenshot of the software: + +* Main interfaces of the software + +![Main interfaces](screenshot/nelderplot.png?raw=true "Main interfaces") + +* The option for half wheel Nelder by selecting the center of rotation + +![Alt text](screenshot/nelderplot_half.png?raw=true "Main interfaces") + +* Another option with a quarter wheel + +![Alt text](screenshot/nelderplot_quarter.png?raw=true "Main interfaces") + +* Standard parameterization may use a rectangle plot + +![Alt text](screenshot/nelderplot_rec_plot.png?raw=true "Main interfaces") + +* The rectangle plot with center of rotation on the plot border + +![Alt text](screenshot/nelderplot_rec_plot_half.png?raw=true "Main interfaces") + +* Option for number of species + +![Alt text](screenshot/nelderplot_full_3sp.png?raw=true "Main interfaces") + +* Two type of species arrangement: Alternate spokes and alternate wheels combination + +![Alt text](screenshot/nelderplot_full_3sp_altspokes.png?raw=true "Main interfaces") + +* The variable information of Nelder plot wheels + +![Alt text](screenshot/nelderplot_variables.png?raw=true "Main interfaces") + +* Data point information for relative plant coordinates + +![Alt text](screenshot/nelderplot_datapoints.png?raw=true "Main interfaces") + +* The KML file can be imported to google map as map layer + +![Alt text](screenshot/gmap1.png?raw=true "Main interfaces") -### Features +* The KML file includes the information of Nelder plot parametrization and design -* Standalone application -* Can be used in R package library -* Saving plot design output as image and data file +![Alt text](screenshot/gmap3.png?raw=true "Main interfaces") ## Nelder Plot Parameters @@ -51,7 +104,7 @@ A_n=r_n^2 θ(α-α^(-1))/2 where θ is degrees between the wheel spokes (Nelder 1962). -## Nelder Plot Parameters for practitioner +### Nelder Plot Parameters for practitioner The parameterization with practical application use the formula proposed by Parrot et al. (2012) to convert the variable into standard Nelder plot parameters. The calculation is as follow: @@ -63,11 +116,11 @@ where α is constant increment, d_1 is minimum planting density, d_1 is maximum where θ is division angle of spokes and t is rectangularity. -r_0 = (20000/(d_1 θ (α**3 - α)))^0.5 +r_0 = (20000/(d_1 θ (α^3 - α)))^0.5 where r_0 is initial wheel radius. ## References * Nelder JA (1962) New kinds of systematic designs for spacing experiments. Biometrics 283–307 -* Parrott DL, Brinks JS, Lhotka JM (2012) Designing Nelder wheel plots for tree density experiments. New Forests 43:245–254. doi: 10.1007/s11056-011-9278-4 +* Parrott DL, Brinks JS, Lhotka JM (2012) Designing Nelder wheel plots for tree density experiments. New Forests 43:245–254. doi: 10.1007/s11056-011-9278-4 \ No newline at end of file diff --git a/screenshot/gmap1.png b/screenshot/gmap1.png new file mode 100644 index 0000000..ee6174a Binary files /dev/null and b/screenshot/gmap1.png differ diff --git a/screenshot/gmap3.png b/screenshot/gmap3.png new file mode 100644 index 0000000..acf8aed Binary files /dev/null and b/screenshot/gmap3.png differ diff --git a/screenshot/nelderplot.png b/screenshot/nelderplot.png new file mode 100644 index 0000000..5e11ad8 Binary files /dev/null and b/screenshot/nelderplot.png differ diff --git a/screenshot/nelderplot_datapoints.png b/screenshot/nelderplot_datapoints.png new file mode 100644 index 0000000..ceeb6b3 Binary files /dev/null and b/screenshot/nelderplot_datapoints.png differ diff --git a/screenshot/nelderplot_full_3sp.png b/screenshot/nelderplot_full_3sp.png new file mode 100644 index 0000000..6e27f0d Binary files /dev/null and b/screenshot/nelderplot_full_3sp.png differ diff --git a/screenshot/nelderplot_full_3sp_altspokes.png b/screenshot/nelderplot_full_3sp_altspokes.png new file mode 100644 index 0000000..d8f0023 Binary files /dev/null and b/screenshot/nelderplot_full_3sp_altspokes.png differ diff --git a/screenshot/nelderplot_half.png b/screenshot/nelderplot_half.png new file mode 100644 index 0000000..076ac4e Binary files /dev/null and b/screenshot/nelderplot_half.png differ diff --git a/screenshot/nelderplot_quarter.png b/screenshot/nelderplot_quarter.png new file mode 100644 index 0000000..dc82ec2 Binary files /dev/null and b/screenshot/nelderplot_quarter.png differ diff --git a/screenshot/nelderplot_rec_plot.png b/screenshot/nelderplot_rec_plot.png new file mode 100644 index 0000000..7c58582 Binary files /dev/null and b/screenshot/nelderplot_rec_plot.png differ diff --git a/screenshot/nelderplot_rec_plot_half.png b/screenshot/nelderplot_rec_plot_half.png new file mode 100644 index 0000000..6d73977 Binary files /dev/null and b/screenshot/nelderplot_rec_plot_half.png differ diff --git a/screenshot/nelderplot_variables.png b/screenshot/nelderplot_variables.png new file mode 100644 index 0000000..8931bca Binary files /dev/null and b/screenshot/nelderplot_variables.png differ