# Summary



# Introduction

**PRIMER 8 with PERMANOVA+** is a substantial upgrade on its predecessor, offering a host of marvelous new tools and statistical methods. These range from simple utilities to make your life easier (such as a tool to easily rename the levels of a factor), through to sophisticated novel analytical methods that are found no-where else (such as dissimilarity-based multivariate control charts, and a valid PERMANOVA test for differences in centroids when dispersions differ). 

This book has been written for those who have some familiarity with prior versions of PRIMER/PERMANOVA+ software. To get started quickly using PRIMER 8 software, first consult the following resource:
- Anderson, M.J. (2026). ["***Get Started with PRIMER 8***."](https://learninghub.primer-e.com/books/get-started-with-primer-8)  *PRIMER-e Learning Hub*. PRIMER-e, Auckland, New Zealand.

For additional details regarding the methods and tools available in the software produced by PRIMER-e, please consult the following ***historical books and manuals***, available in the [PRIMER-e Learning Hub](https://learninghub.primer-e.com):
- Clarke KR, Gorley RN, Somerfield PJ & Warwick RM. (2014). ["***Change in Marine Communities, 3rd edition***."](https://learninghub.primer-e.com/books/change-in-marine-communities) PRIMER-E Ltd: Plymouth, UK.
- Clarke KR & Gorley RN. (2015). ["***PRIMER v7: User Manual / Tutorial***."](https://learninghub.primer-e.com/books/primer-v7-user-manual-tutorial) PRIMER-E Ltd: Plymouth, UK.
- Anderson MJ, Gorley RN & Clarke KR. (2008). ["***PERMANOVA+ for PRIMER: Guide to Software and Statistical Methods***."](https://learninghub.primer-e.com/books/permanova-for-primer-guide-to-software-and-statistical-methods) PRIMER-E Ltd: Plymouth, UK.


In this text, we will refer to the new version (including PERMANOVA+) as '**P8**', and to the previous version as '**P7**'. What follows is a short list of the most important new features in P8. These items have been classified into two major groups: [***New Statistical Methods in P8***](https://learninghub.primer-e.com/link/952) and [***New Tools & Utilities in P8***](https://learninghub.primer-e.com/link/953). Just click on any link from within either of these lists to explore what is new!

# New Statistical Methods in P8

Most of the methods in the list below are unique to PRIMER 8 and are not available in any other software package. Some of the methods are not new (such as the non-parametric univariate Mann-Whitney U test), but are implemented in a novel way in P8. 
- [**Expanded summary statistics**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/chapter/1-expanded-summary-statistics) - Summarise your variables (or samples) with ease, using a host of standard statistics (e.g., average, median, range, min, max, nominated quantiles, skewness, kurtosis, etc.) and/or using several other bespoke diagnostic measures, such as frequencies of occurrence, the number of singletons or doubletons, or the smallest value above a given threshold, etc. You can also calculate summaries on data split by a factor (or indicator).<br><br> 
- [**Empirical distributions**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/chapter/2-empirical-distributions) - Create raw or cumulative empirical distributions and view them graphically.<br><br>
- [**Dot plots and violin plots**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/chapter/3-dot-plots-and-violin-plots) - Dot plots and violin plots offer a great way to visualise the empirical shape of distributions of sample values across multiple groups for any individual variable.<br><br>
- [**Univariate non-parametric methods**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/chapter/4-univariate-non-parametric-methods) - In P8 you can now implement many standard non-parametric univariate statistical tests. PRIMER's implementation of these tests is novel in that all of these rely on robust permutation algorithms and automatically output relevant graphics as well. Available tests include:
  - [***Wilcoxon Signed-Rank test***](https://learninghub.primer-e.com/books/whats-new-in-primer-8/page/41-wilcoxon-signed-rank-test) (paired 2-sample);
  - [***Mann-Whitney U test***](https://learninghub.primer-e.com/books/whats-new-in-primer-8/page/43-mann-whitney-u-test) (unpaired 2-sample);
  - [***Kruskal-Wallis test***](https://learninghub.primer-e.com/books/whats-new-in-primer-8/page/45-kruskal-wallis-test) (compare multiple groups);
  - [***Kolmogorov-Smirnov test***](https://learninghub.primer-e.com/books/whats-new-in-primer-8/page/47-kolmogorov-smirnov-test) (compare empirical distributions); and
  - [***Test of Association***](https://learninghub.primer-e.com/books/whats-new-in-primer-8/page/49-test-of-association) (between 2 variables).<br><br>
- [**New PERMANOVA Design file**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/chapter/5-new-permanova-design-file) - The interface for specifying a given study design and various defaults for PERMANOVA have been re-vamped. In P8 it is now easier to specify or modify the design and to fine-tune the model, to add/remove or pool terms, to include/exclude interactions with or among covariates, or to reset the full list of terms implied by a given study design.<br><br>
- [**Allow heterogeneous dispersions**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/chapter/6-allow-heterogeneous-dispersions-in-permanova) - We have provided some solutions to the multivariate Behrens-Fisher problem for dissimilarity-based analyses ({{@954#bkmrk-andersonetal2017}}). PERMANOVA in P8 now allows you to test for differences in multivariate centroids while allowing for heterogeneity in multivariate dispersions.<br><br>
- [**Finite factors**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/chapter/7-finite-factors) - The notion of a fixed *vs* a random factor need not be seen as a strict dichotomy, but rather as a progression ({{@954#bkmrk-andersonetal2025}}). With PERMANOVA in P8, there is a new factor type called 'Finite', in which the user can specify the number of levels in the population from which sampled levels have been drawn. Doing this can greatly increase the power of inferential tests, and is especially useful for tests in broad-scale environmental impact study designs.<br><br>
- [**Split-plot and repeated measures designs**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/chapter/8-specify-subjectwhole-plot-error-in-permanova) - PERMANOVA in P8 has a new factor type called 'Subject/Whole-plot error', so you can specify sources of error at multiple levels in the study design. This enables repeated measures, split-plot (and split-split-plot, etc.) study designs to be analysed easily and directly.<br><br>
- [**Tests for cyclicity: grouping covariates**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/chapter/9-group-covariates) - PERMANOVA in P8 allows you to group multiple covariates together (using an indicator), which opens the door to new ways of analysing multivariate patterns of periodicity, cyclicity and other spatio-temporal models.<br><br>
- [**Centroid plots**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/chapter/10-centroid-plots) - New centroid plots allow you to visualise the relative importance of main effects from a multi-factorial PERMANOVA model ([**Main Effects Plot**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/page/102-main-effects-plot)) and to explore the patterns among cell centroids from complex PERMANOVA study designs ([**Interaction Plot**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/page/103-interaction-plot)), all constructed in the space of your chosen resemblance measure.<br><br>
- [**Residual distances/dissimilarities**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/chapter/11-residual-distances) - Remove the effects of one or more dominant factors (*via* PERMANOVA) or regressors (*via* DISTLM) and output a residual distance/dissimilarity matrix among the sampling units. Ordination of a residual distance matrix permits visualisation of non-dominant factors.<br><br>
- [**Multivariate control charts**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/chapter/12-control-charts) - Create a multivariate control chart on the basis of a chosen resemblance measure. You can build a chart through time (using progressive, baseline or moving-window criteria) and detect when an individual observation is 'out-of-control', given previous observations. This is a fantastic tool for monitoring applications.<br><br>
- [**New standardisation options**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/chapter/13-new-standardisation-options) - Perform standardisations of samples (or variables) separately within groups (or levels) of indicators (or factors), output values as raw or cumulative percentages or proportions, with ordering specified by you.<br><br>
- [**Create ordered groups from a continuous variable**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/chapter/14-create-ordered-groups) - Generate a new factor which consists of ordered groups, based on any chosen continuous variable, with a plethora of optional criteria for defining suitable group boundaries. For example, you can specify quantiles as 'breaks', or create a given number of groups with equal sample sizes per group, or minimise the within-group sum-of-squares, etc.<br><br>
- [**Multi-factor means plots**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/chapter/16-means-plots) - Create univariate bar plots or point plots of mean values for factors, with error bars corresponding to standard errors/deviations, or your choice of confidence interval, using either bootstrap percentiles or classical methods. Split your data by additional factors, either within a plot or across different plots, and customise the colours, symbols and/or joining lines.

# New Tools & Utilities in P8

- [**New default colour palette**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/page/151-new-default-colour-palette) - The new colour palette for PRIMER graphics ensures distinctive colours by default that carefully accommodate several different forms of colour-blindness.<br><br>
- [**New selection options**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/page/152-new-selection-options) - Select subsets of variables and/or samples by names (using special filters) or numbers, or according to your own rules regarding zero or missing values, frequencies of occurrence, percent contributions to abundances overall or in any one sample, and more.<br><br>
- [**Re-name levels of a factor (or indicator)**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/page/153-re-name-levels-of-a-factor-or-indicator) - Rapidly duplicate factors (or indicators) and re-name the levels (groups) for that factor (or indicator).<br><br>
- [**Add customised values/labels to graphical axes**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/page/154-add-customised-valueslabels-to-graphical-axes) - Customise your graphics with more tools for modifying X and Y axes. You can show bespoke additional values/labels on your axes and/or change the label orientation.<br><br>
- [**Split data sheet by factor/indicator**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/page/155-split-data-sheet-by-factorindicator) - Split a single data sheet into multiple sheets based on a factor or indicator of your choice.<br><br>
- [**New facility in line plots**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/page/156-line-plots-for-samples) - Draw line plots either: (i) of individual samples (across variables); or (ii) of individual variables (across samples).<br><br>
- [**Output group-level stats from dispersion (or variability) weighting**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/page/157-output-group-level-stats-from-dispersion-or-variability-weighting) - Output the individual group-level statistics calculated for the pre-treatment options of dispersion (or variability) weighting.<br><br>
- [**Output diagnostic plots from CAP**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/page/158-output-diagnostic-plots-from-cap) - Models produced using canonical analysis of principal coordinates (CAP) require investigation of leave-one-out diagnostics for different chosen values of $m$ (= the number of PCO axes used for the model). In P8, all of these diagnostics are now produced in plots for direct visual inspection.<br><br>
- [**New diagnostics for PCA/PCO plots**](https://learninghub.primer-e.com/books/whats-new-in-primer-8/page/159-new-diagnostics-for-pcapco-plots) - In P8, you can now assess how well a PCA or PCO plot represents the original inter-sample distances or dissimilarities through a Shepard digram and an associated calculation of stress.