FeatureNearest

FeatureNearest[{elem1,elem2,},x]

gives the list of elemi to which x is nearest in a computed feature space.

FeatureNearest[{elem1v1,elem2v2,},x]

gives the vi corresponding to the elemi to which x is nearest.

FeatureNearest[{elem1,elem2,}{v1,v2,},x]

gives the same result.

FeatureNearest[{elem1,elem2,}prop,x]

gives the property prop for the elemi to which x is nearest.

FeatureNearest[data,{x1,x2,}]

effectively gives {FeatureNearest[data,x1],FeatureNearest[data,x2],}.

FeatureNearest[data,x,n]

gives the n nearest elemi to x.

FeatureNearest[data]

generates a NearestFunction[] that can be applied repeatedly to different x.

Details and Options

  • FeatureNearest can be used on many types of data, including numerical, textual, sounds and images, as well as combinations of these.
  • Each elemi can be a single data element, a list of data elements, an association of data elements or a Dataset object. In FeatureNearest[data,], data can be a Dataset object.
  • In FeatureNearest[{elem1,elem2,}prop,], possible forms for prop include:
  • "Element"the elemi found to be nearest
    "Index"the index i of the elemi found to be nearest
    "Distance"the distance to the nearest elemi
    {prop1,prop2,}a list of multiple forms
    Allan association giving element, index and distance
  • When several elements are returned, the nearest ones are given first.
  • FeatureNearest is typically equivalent to using Nearest in the space created by FeatureExtract.
  • The following options can be given:
  • DistanceFunctionAutomaticthe distance metric to use
    FeatureExtractorIdentityhow to extract features
    FeatureTypesAutomaticfeature types to assume for input data
    MethodAutomaticmethod to use
  • Possible settings for Method include "Octree", "KDtree" and "Scan".

Examples

open allclose all

Basic Examples  (1)

Generate a nearest function using FeatureNearest:

In[1]:=
Click for copyable input
Out[1]=

Find the example in the dataset that is nearest to a new example:

In[2]:=
Click for copyable input
Out[2]=

Perform the above operation in one step:

In[3]:=
Click for copyable input
Out[3]=

Scope  (4)

Options  (4)

Applications  (2)

See Also

Nearest  FeatureExtraction  FeatureDistance  ClusterClassify  DimensionReduction

Introduced in 2017
(11.1)