EC CLOSE - Extract Connected Clusters - merge close clusters

PURPOSE

Merges neighboring clusters of voxels in a 3D volume into a single "object" or lower hierarchical-level cluster.
Reads a SPIDER document file containing cluster centers of mass. Determines distances between all clusters. If the distance between two clusters is less than the solicited threshold, it sets higher-numbered cluster voxels to the same identification number posessed by the lower-numbered cluster.   Example.

SEE ALSO

EC SELECT	[Extract Connected Clusters - Selection]
EC CL	[Extract Connected Clusters]
EC FILTER	[Extract Connected Clusters - Filter]
EC STAT	[Extract Connected Clusters - Statistics]

USAGE

.OPERATION: EC CLOSE

.CENTER-OF-MASS DOC FILE: doc003
[Contains cluster numbers and centers of masses. Usually prepared using operation 'EC STAT' The document file needs 4 register columns:

Col.	Role	Contents
1	Key	Cluster number + 1
2	# of Regs.	4
3	Reg.	Number of voxels in cluster
4	Reg.	X Center-of-mass
5	Reg.	Y Center-of-mass
6	Reg.	Z Center-of-mass

.THRESHOLD DISTANCE & INITIAL CLUSTER: 15, 2
[Clusters closer together than specified threshold distance are given same cluster number. Clusters below the the initial cluster number are ignored.]

.CLUSTER INPUT FILE: VVV001
[Usually a cluster file produced by running 'EC CL'.]

.CLUSTER OUTPUT VOLUME: VVV002
[Contains remapped cluster numbers.]

NOTES

1. The document file has same column format as 'EC STAT' output.

SUBROUTINES

MAPDIST, MAKTAB, MAPIM

CALLER

UTIL6