milvus/client/entity/vectors.go

134 lines
3.3 KiB
Go

// Licensed to the LF AI & Data foundation under one
// or more contributor license agreements. See the NOTICE file
// distributed with this work for additional information
// regarding copyright ownership. The ASF licenses this file
// to you under the Apache License, Version 2.0 (the
// "License"); you may not use this file except in compliance
// with the License. You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package entity
import (
"github.com/milvus-io/milvus/pkg/util/typeutil"
)
// Vector interface vector used int search
type Vector interface {
Dim() int
Serialize() []byte
FieldType() FieldType
}
// FloatVector float32 vector wrapper.
type FloatVector []float32
// Dim returns vector dimension.
func (fv FloatVector) Dim() int {
return len(fv)
}
// entity.FieldType returns coresponding field type.
func (fv FloatVector) FieldType() FieldType {
return FieldTypeFloatVector
}
// Serialize serializes vector into byte slice, used in search placeholder
// LittleEndian is used for convention
func (fv FloatVector) Serialize() []byte {
return typeutil.Float32ArrayToBytes(fv)
}
func (fv FloatVector) ToFloat16Vector() Float16Vector {
return typeutil.Float32ArrayToFloat16Bytes(fv)
}
// SerializeToBFloat16Bytes serializes vector into bfloat16 byte slice,
// used in search placeholder
func (fv FloatVector) ToBFloat16Vector() BFloat16Vector {
return typeutil.Float32ArrayToBFloat16Bytes(fv)
}
// FloatVector float32 vector wrapper.
type Float16Vector []byte
// Dim returns vector dimension.
func (fv Float16Vector) Dim() int {
return len(fv) / 2
}
// entity.FieldType returns coresponding field type.
func (fv Float16Vector) FieldType() FieldType {
return FieldTypeFloat16Vector
}
func (fv Float16Vector) Serialize() []byte {
return fv
}
func (fv Float16Vector) ToFloat32Vector() FloatVector {
return typeutil.Float16BytesToFloat32Vector(fv)
}
// FloatVector float32 vector wrapper.
type BFloat16Vector []byte
// Dim returns vector dimension.
func (fv BFloat16Vector) Dim() int {
return len(fv) / 2
}
// entity.FieldType returns coresponding field type.
func (fv BFloat16Vector) FieldType() FieldType {
return FieldTypeBFloat16Vector
}
func (fv BFloat16Vector) Serialize() []byte {
return fv
}
func (fv BFloat16Vector) ToFloat32Vector() FloatVector {
return typeutil.BFloat16BytesToFloat32Vector(fv)
}
// BinaryVector []byte vector wrapper
type BinaryVector []byte
// Dim return vector dimension, note that binary vector is bits count
func (bv BinaryVector) Dim() int {
return 8 * len(bv)
}
// Serialize just return bytes
func (bv BinaryVector) Serialize() []byte {
return bv
}
// entity.FieldType returns coresponding field type.
func (bv BinaryVector) FieldType() FieldType {
return FieldTypeBinaryVector
}
type Text string
// Dim returns vector dimension.
func (t Text) Dim() int {
return 0
}
// entity.FieldType returns coresponding field type.
func (t Text) FieldType() FieldType {
return FieldTypeVarChar
}
func (t Text) Serialize() []byte {
return []byte(t)
}