The  .vectors.distanceByEmbedding  algorithm

The .vectors.distanceByEmbedding algorithm computes the distance between an embedding vector and the embedding of an input node. The distance is the squared L2 norm of the input (source) embedding vector and the embedding vector of the (target) input node.

.vectors.distanceByEmbedding  syntax

WITH [*an embedding*] as embedding 
MATCH( n {`~id`: "the ID of the target node(s)"} )
CALL neptune.algo.vectors.distanceByEmbedding(embedding, n)
YIELD distance
RETURN embedding, n, distance

.vectors.distanceByEmbedding  inputs

.vectors.distanceByEmbedding  outputs

For every pair of source node and target node:

.vectors.distanceByEmbedding  query examples

WITH [1.1, 1.2, 1.3, 1.4] as embedding 
MATCH (n)
WHERE id(n)="v1"
CALL neptune.algo.vectors.distanceByEmbedding(embedding, n)
YIELD distance
RETURN embedding, n, distance

UNWIND [ {id: "933", embedding: [1,2,3,4]}, 
         {id: "934", embedding: [-1,-2,-3,-4]} ] as entry 
MATCH (n:person) WHERE id(n)=entry.id WITH n, entry.embedding as embedding
CALL neptune.algo.vectors.distanceByEmbedding(embedding, n) 
YIELD distance
RETURN embedding, n, distance

Sample  .vectors.distanceByEmbedding  output

Here is an example of the output returned by .vectors.distanceByEmbedding when run against a sample Wikipedia dataset using the following query:

aws neptune-graph execute-query \
  --graph-identifier ${graphIdentifier} \
  --query-string "***embedding part***
                       MATCH (n{`~id`: '1'})
                       CALL neptune.algo.vectors.distanceByEmbedding(embedding, n)
                       YIELD distance
                       RETURN embedding, n, distance" \
  --language open_cypher \
  /tmp/out.txt

{
  "results": [
    {
      "embedding": [***embedding***],
      "n": {
        "~id": "1",
        "~entityType": "node",
        "~labels": [],
        "~properties": {
          "title": "24-hour clock",
          "views": 2450.62548828125,
          "wiki_id": 9985,
          "paragraph_id": 1,
          "url": "https://simple.wikipedia.org/wiki?curid=9985",
          "langs": 30,
          "text": "A time in the 24-hour clock is written in the form hours:minutes (for example\\, 01:23)\\, or hours:minutes:seconds (01:23:45). Numbers under 10 have a zero in front (called a leading zero); e.g. 09:07. Under the 24-hour clock system\\, the day begins at midnight\\, 00:00\\, and the last minute of the day begins at 23:59 and ends at 24:00\\, which is identical to 00:00 of the following day. 12:00 can only be mid-day. Midnight is called 24:00 and is used to mean the end of the day and 00:00 is used to mean the beginning of the day. For example\\, you would say \"Tuesday at 24:00\" and \"Wednesday at 00:00\" to mean exactly the same time."
        }
      },
      "distance": 27.762847900390626
    }
  ]
}