Method insert

vicinity/vicinity.py:236–253

Insert new items into the vector space. :param tokens: A list of items to insert into the vector space. :param vectors: The vectors to insert into the vector space. :raises ValueError: If the tokens and vectors are not the same length.

(self, tokens: Sequence[T], vectors: npt.NDArray)

        return instance

    def insert(self, tokens: Sequence[T], vectors: npt.NDArray) -> None:
        """
        Insert new items into the vector space.

        :param tokens: A list of items to insert into the vector space.
        :param vectors: The vectors to insert into the vector space.
        :raises ValueError: If the tokens and vectors are not the same length.
        """
        if len(tokens) != len(vectors):
            raise ValueError(f"Your tokens and vectors are not the same length: {len(tokens)} != {len(vectors)}")

        if vectors.shape[1] != self.dim:
            raise ValueError("The inserted vectors must have the same dimension as the backend.")

        self.items.extend(tokens)
        self.backend.insert(vectors)
        if self.vector_store is not None:
            self.vector_store.insert(vectors)

    def delete(self, tokens: Sequence[T]) -> None:
        """