ADDPOINTS directive

Adds points for new objects to a principal coordinates analysis.

Option

PRINT = strings

Printed output required (coordinates, residuals); default * i.e. no printing

Parameters

NEWDISTANCES = matrices

Squared distances of the new objects from the original points

LRV = LRVs

Latent roots and vectors from the PCO analysis

CENTROID = diagonal matrices

Centroid distances from the PCO analysis

COORDINATES = matrices

Saves the coordinates of the additional points in the space of the original points

RESIDUALS = matrices or variates

Saves the residuals of the new objects from that space

Description

The input to ADDPOINTS is specified by the first three parameters. The NEWDISTANCES parameter specifies an s×n matrix containing squared distances of the s new units from the n old units. The LRV and CENTROID parameters specify structures defining the configuration of old units; these have usually been produced by a PCO statement.

The PRINT option controls the printed output with settings:

coordinates

to print the coordinates of the new points;

residuals

to print the residual distances of the new units from the coordinates in the space of the old units.

The other parameters can be used to save the results: the COORDINATES parameter allows you to specify an s×k matrix to save the coordinates for the new units, and the residuals can be saved in an s×1 matrix using the RESIDUALS parameter. The value k is determined by the dimensionality of the input coordinates from the preceding PCO statement.

Option: PRINT.

Parameters: NEWDISTANCES, LRV, CENTROID, COORDINATES, RESIDUALS.