diff --git a/classes/APIError.html b/classes/APIError.html index 933ed7f..94a6682 100644 --- a/classes/APIError.html +++ b/classes/APIError.html @@ -1,4 +1,4 @@ -APIError | @nomic-ai/atlas

Hierarchy

  • Error
    • APIError

Constructors

constructor +APIError | @nomic-ai/atlas

Hierarchy

  • Error
    • APIError

Constructors

Properties

Methods

Constructors

  • Parameters

    • status: number
    • statusText: string
    • headers: any
    • Optional responseBody: string

    Returns APIError

Properties

headers: any
message: string
name: string
responseBody: null | string
stack?: string
status: number
statusText: string
prepareStackTrace?: ((err, stackTraces) => any)

Optional override for formatting stack traces

+

Constructors

  • Parameters

    • status: number
    • statusText: string
    • headers: any
    • Optional responseBody: string

    Returns APIError

Properties

headers: any
message: string
name: string
responseBody: null | string
stack?: string
status: number
statusText: string
prepareStackTrace?: ((err, stackTraces) => any)

Optional override for formatting stack traces

Type declaration

    • (err, stackTraces): any
    • Parameters

      • err: Error
      • stackTraces: CallSite[]

      Returns any

stackTraceLimit: number

Methods

  • Create .stack property on a target object

    Parameters

    • targetObject: object
    • Optional constructorOpt: Function

    Returns void

\ No newline at end of file diff --git a/classes/AtlasIndex.html b/classes/AtlasIndex.html index 2983084..5e100b4 100644 --- a/classes/AtlasIndex.html +++ b/classes/AtlasIndex.html @@ -1,4 +1,4 @@ -AtlasIndex | @nomic-ai/atlas

Hierarchy

  • BaseAtlasClass<{}>
    • AtlasIndex

Constructors

constructor +AtlasIndex | @nomic-ai/atlas

Hierarchy

  • BaseAtlasClass<{}>
    • AtlasIndex

Constructors

Properties

_attr: undefined | {}

Type declaration

    _projections?: AtlasProjection[] = undefined
    attributePromise: undefined | Promise<{}>
    id: string
    project: AtlasProject
    viewer: AtlasViewer

    Accessors

    • get attr(): undefined | AttributesType
    • returns the object's information; this may be undefined

      -

      Returns undefined | AttributesType

    Methods

    • Parameters

      • endpoint: string
      • method: "GET" | "POST"
      • payload: Payload = null
      • headers: null | Record<string, string> = null

      Returns Promise<null | string | any[] | Record<string, any> | Uint8Array | Table<any>>

    • Parameters

      • ids: string[] | number[] | bigint[]

        a list of ids (atom_ids, which are scoped to the index level) to fetch. If passing +

    Constructors

    Properties

    _attr: undefined | {}

    Type declaration

      _projections?: AtlasProjection[] = undefined
      attributePromise: undefined | Promise<{}>
      id: string
      project: AtlasProject
      viewer: AtlasViewer

      Accessors

      • get attr(): undefined | AttributesType
      • returns the object's information; this may be undefined

        +

        Returns undefined | AttributesType

      Methods

      • Parameters

        • endpoint: string
        • method: "GET" | "POST"
        • payload: Payload = null
        • headers: null | Record<string, string> = null

        Returns Promise<null | string | any[] | Record<string, any> | Uint8Array | Table<any>>

      • Parameters

        • ids: number[] | string[] | bigint[]

          a list of ids (atom_ids, which are scoped to the index level) to fetch. If passing datum_ids, use the project-level fetchIds method. This API is subject to change.

        Returns Promise<any>

        a list of Records containing metadata for each atom.

        -
      • Returns string

      • Fetches basic information about the object. +

      • Returns string

      • Fetches basic information about the object. By default, this caches the call; if you want to bust the cache, pass true as the first argument. This immediately.

        Parameters

        • bustCache: boolean = false

          Whether to refetch the relevant information

        Returns Promise<{}>

        A promise that resolves to the organization info.

        -
      • Parameters

        • nn_options: NNOptions

        Returns Promise<Table<any>>

        A table containing the nearest neighbors for each atom.

        -
      • Parameters

        • param0: Omit<{
              atlas_index_id: string;
              k?: number;
              queries: string | number[][];
          }, "atlas_index_id">

          A keyed dictionary including k (the number of neighbors to return) +

      • Parameters

        • nn_options: NNOptions

        Returns Promise<Table<any>>

        A table containing the nearest neighbors for each atom.

        +
      • Parameters

        • param0: Omit<{
              atlas_index_id: string;
              k?: number;
              queries: string | number[][];
          }, "atlas_index_id">

          A keyed dictionary including k (the number of neighbors to return) and queries (a list of vectors to search for).

          -

        Returns Promise<{
            distances: number[][];
            neighbors: string[][];
        }>

      • Loads the information associated with the class, removing any +

      Returns Promise<{
          distances: number[][];
          neighbors: string[][];
      }>

      \ No newline at end of file +
      \ No newline at end of file diff --git a/classes/AtlasOrganization.html b/classes/AtlasOrganization.html index 2c65bba..686429d 100644 --- a/classes/AtlasOrganization.html +++ b/classes/AtlasOrganization.html @@ -1,4 +1,4 @@ -AtlasOrganization | @nomic-ai/atlas

      Class AtlasOrganization

      Hierarchy

      • BaseAtlasClass<OrganizationInfo>
        • AtlasOrganization

      Constructors

      constructor +AtlasOrganization | @nomic-ai/atlas

      Class AtlasOrganization

      Hierarchy

      • BaseAtlasClass<OrganizationInfo>
        • AtlasOrganization

      Constructors

      Properties

      _attr: undefined | OrganizationInfo
      attributePromise: undefined | Promise<OrganizationInfo>
      id: string
      viewer: AtlasViewer

      Accessors

      • get attr(): undefined | AttributesType
      • returns the object's information; this may be undefined

        -

        Returns undefined | AttributesType

      Methods

      • Parameters

        • endpoint: string
        • method: "GET" | "POST"
        • payload: Payload = null
        • headers: null | Record<string, string> = null

        Returns Promise<null | string | any[] | Record<string, any> | Uint8Array | Table<any>>

      • Fetches basic information about the object. +

      Constructors

      Properties

      _attr: undefined | OrganizationInfo
      attributePromise: undefined | Promise<OrganizationInfo>
      id: string
      viewer: AtlasViewer

      Accessors

      • get attr(): undefined | AttributesType
      • returns the object's information; this may be undefined

        +

        Returns undefined | AttributesType

      Methods

      • Parameters

        • endpoint: string
        • method: "GET" | "POST"
        • payload: Payload = null
        • headers: null | Record<string, string> = null

        Returns Promise<null | string | any[] | Record<string, any> | Uint8Array | Table<any>>

      • Fetches basic information about the object. By default, this caches the call; if you want to bust the cache, pass true as the first argument. This immediately.

        Parameters

        • bustCache: boolean = false

          Whether to refetch the relevant information

        Returns Promise<OrganizationInfo>

        A promise that resolves to the organization info.

        -
      • Returns Promise<{
            created_timestamp: string;
            creator: string;
            creator_nickname: string;
            creator_picture: string;
            description: string;
            id: string;
            is_public: boolean;
            is_public_to_org: boolean;
            modality?: string;
            nickname: string;
            organization_name: string;
            organization_slug: string;
            owner: string;
            project_fields: string[];
            project_name: string;
            slug: string;
            thumbnail: string;
            total_datums_in_project: number;
            unique_id_field: string;
        }[]>

      • Loads the information associated with the class, removing any +

      • Returns Promise<{
            created_timestamp: string;
            creator: string;
            creator_nickname: string;
            creator_picture: string;
            description: string;
            id: string;
            is_public: boolean;
            is_public_to_org: boolean;
            modality?: string;
            nickname: string;
            organization_name: string;
            organization_slug: string;
            owner: string;
            project_fields: string[];
            project_name: string;
            slug: string;
            thumbnail: string;
            total_datums_in_project: number;
            unique_id_field: string;
        }[]>

      • Loads the information associated with the class, removing any existing caches.

        Returns Promise<LoadedObject<AtlasOrganization, OrganizationInfo>>

        a LoadedObject instance of the class that is guaranteed to have its attr slot populated with appropriate information.

        Example

        const loadedProject = await (new AtlasProject(projectId)).withLoadedAttributes()

        // OR, in cases where we want to do stuff immediately with the project and ensure
        // that later calls there don't double-fetch information.

        const project = new AtlasProject(projectId)

        // do stuff right away.
        const projection = new AtlasProjection(projectionId, {project: project})
        const loadedProjection = await projection.withLoadedAttributes()
        // do stuff with loadedProjection
        -
      \ No newline at end of file +
      \ No newline at end of file diff --git a/classes/AtlasProject.html b/classes/AtlasProject.html index fa7f285..1bf744a 100644 --- a/classes/AtlasProject.html +++ b/classes/AtlasProject.html @@ -1,7 +1,7 @@ AtlasProject | @nomic-ai/atlas

      Class AtlasProject

      An AtlasDataset represents a single mutable dataset in Atlas. It provides an interfaces to upload, update, and delete data, as well as create and delete indices which handle specific views.

      -

      Hierarchy

      • BaseAtlasClass<Atlas.ProjectInfo>
        • AtlasProject

      Constructors

      Hierarchy

      • BaseAtlasClass<Atlas.ProjectInfo>
        • AtlasProject

      Constructors

      Properties

      _attr _indices _schema? @@ -31,22 +31,22 @@ an existing project, use the create_project or load_project functions.

    • Optional user: AtlasViewer | AtlasUser

      An existing AtlasUser object. If not provided, a new one will be created.

    • Returns AtlasProject

      An AtlasDataset object.

      -

      Properties

      _attr: undefined | ProjectInfo
      _indices: AtlasIndex[] = []
      _schema?: null | Schema<any>
      attributePromise: undefined | Promise<ProjectInfo>
      id: string
      viewer: AtlasViewer

      Accessors

      • get attr(): undefined | AttributesType
      • returns the object's information; this may be undefined

        -

        Returns undefined | AttributesType

      • get schema(): undefined | null | Schema<any>
      • Returns undefined | null | Schema<any>

      Methods

      • Parameters

        • records: Record<string, string>[]

        Returns Promise<void>

      • Parameters

        • endpoint: string
        • method: "GET" | "POST"
        • payload: Payload = null
        • headers: null | Record<string, string> = null

        Returns Promise<null | string | any[] | Record<string, any> | Uint8Array | Table<any>>

      • Returns Promise<null | string | any[] | Record<string, any> | Uint8Array | Table<any>>

      • Parameters

        • ids: string[]

        Returns Promise<void>

      • Returns string

      • Fetches basic information about the object. +

      Properties

      _attr: undefined | ProjectInfo
      _indices: AtlasIndex[] = []
      _schema?: null | Schema<any>
      attributePromise: undefined | Promise<ProjectInfo>
      id: string
      viewer: AtlasViewer

      Accessors

      • get attr(): undefined | AttributesType
      • returns the object's information; this may be undefined

        +

        Returns undefined | AttributesType

      • get schema(): undefined | null | Schema<any>
      • Returns undefined | null | Schema<any>

      Methods

      • Parameters

        • records: Record<string, string>[]

        Returns Promise<void>

      • Parameters

        • endpoint: string
        • method: "GET" | "POST"
        • payload: Payload = null
        • headers: null | Record<string, string> = null

        Returns Promise<null | string | any[] | Record<string, any> | Uint8Array | Table<any>>

      • Returns Promise<null | string | any[] | Record<string, any> | Uint8Array | Table<any>>

      • Parameters

        • ids: string[]

        Returns Promise<void>

      • Returns string

      • Fetches basic information about the object. By default, this caches the call; if you want to bust the cache, pass true as the first argument. This immediately.

        Parameters

        • bustCache: boolean = false

          Whether to refetch the relevant information

        Returns Promise<ProjectInfo>

        A promise that resolves to the organization info.

        -
      • Parameters

        • Optional ids: string[]

          A list of identifiers to fetch from the server.

          -

        Returns Promise<Record<string, Record<string, any>>>

      • Returns Promise<ProjectionInfo[]>

        A list of projection summaries, sorted so that the first is +

      • Parameters

        • Optional ids: string[]

          A list of identifiers to fetch from the server.

          +

        Returns Promise<Record<string, Record<string, any>>>

      • Returns Promise<ProjectionInfo[]>

        A list of projection summaries, sorted so that the first is the most useable (defined as ready and newest)

        -
      • Updates all indices associated with a project.

        +
      • Updates all indices associated with a project.

        Parameters

        • rebuild_topic_models: boolean = false

          If true, rebuilds topic models for all indices.

          -

        Returns Promise<void>

      • Parameters

        • table: Uint8Array | Table<any>

        Returns Promise<void>

      • Loads the information associated with the class, removing any +

      Returns Promise<void>

      • Parameters

        • table: Uint8Array | Table<any>

        Returns Promise<void>

      • Loads the information associated with the class, removing any existing caches.

        Returns Promise<LoadedObject<AtlasProject, ProjectInfo>>

        a LoadedObject instance of the class that is guaranteed to have its attr slot populated with appropriate information.

        Example

        const loadedProject = await (new AtlasProject(projectId)).withLoadedAttributes()

        // OR, in cases where we want to do stuff immediately with the project and ensure
        // that later calls there don't double-fetch information.

        const project = new AtlasProject(projectId)

        // do stuff right away.
        const projection = new AtlasProjection(projectionId, {project: project})
        const loadedProjection = await projection.withLoadedAttributes()
        // do stuff with loadedProjection
        -
      \ No newline at end of file +
      \ No newline at end of file diff --git a/classes/AtlasProjection.html b/classes/AtlasProjection.html index e7358e0..7ccb0c0 100644 --- a/classes/AtlasProjection.html +++ b/classes/AtlasProjection.html @@ -1,4 +1,4 @@ -AtlasProjection | @nomic-ai/atlas

      Class AtlasProjection

      Hierarchy

      • BaseAtlasClass<ProjectGetInfo>
        • AtlasProjection

      Constructors

      constructor +AtlasProjection | @nomic-ai/atlas

      Class AtlasProjection

      Hierarchy

      • BaseAtlasClass<ProjectGetInfo>
        • AtlasProjection

      Constructors

      Properties

      _attr _index? _project? @@ -28,7 +28,7 @@

      Constructors

      • Parameters

        • id: string

          The UUID of the projection to retrieve.

        • Optional user: AtlasViewer | AtlasUser

          The user object to query with.

        • options: ProjectionInitializationOptions = {}

          Options for initializing the projection.

          -

        Returns AtlasProjection

      Properties

      _attr: undefined | {
          access_role: string;
          atlas_indices: {
              atoms: string[];
              colorable_fields: string[];
              created_timestamp: string;
              embedders: {
                  atlas_index_id: string;
                  hyperparameters: Record<string, never>;
                  id: string;
                  model_name: string;
                  ready: boolean;
              }[];
              id: string;
              index_name: string;
              indexed_field: string;
              nearest_neighbor_indices: {
                  atom_strategies: string[];
                  hyperparameters: Record<string, never>;
                  id: string;
                  index_name: string;
                  ready: boolean;
              }[];
              project_id: string;
              projections: {
                  atom_strategies: string[];
                  created_timestamp: string;
                  hyperparameters: Record<string, never>;
                  id: string;
                  og_image?: string;
                  projection_name: string;
                  ready: boolean;
                  thumbnail?: string;
                  updated_timestamp: string;
              }[];
              updated_timestamp: string;
          }[];
          created_timestamp: string;
          creator: string;
          creator_nickname: string;
          creator_picture: string;
          description: string;
          id: string;
          insert_update_delete_lock: boolean;
          is_public: boolean;
          is_public_to_org: boolean;
          modality?: string;
          og_image: string;
          organization_name: string;
          organization_slug: string;
          owner: string;
          permissions: {
              dataset:administration:read: boolean;
              dataset:administration:write: boolean;
              dataset:data:read: boolean;
              dataset:data:write: boolean;
              dataset:members:read: boolean;
              dataset:members:write: boolean;
              dataset:metadata:read: boolean;
              dataset:metadata:write: boolean;
              dataset:tags:read: boolean;
              dataset:tags:write: boolean;
          };
          project_fields: string[];
          project_name: string;
          schema?: string;
          slug: string;
          total_datums_in_project: number;
          unique_id_field: string;
      }

      Type declaration

      • access_role: string

        Access Role

        +

      Returns AtlasProjection

      Properties

      _attr: undefined | {
          access_role: string;
          atlas_indices: {
              atoms: string[];
              colorable_fields: string[];
              created_timestamp: string;
              embedders: {
                  atlas_index_id: string;
                  hyperparameters: Record<string, never>;
                  id: string;
                  model_name: string;
                  ready: boolean;
              }[];
              id: string;
              index_name: string;
              indexed_field: string;
              nearest_neighbor_indices: {
                  atom_strategies: string[];
                  hyperparameters: Record<string, never>;
                  id: string;
                  index_name: string;
                  ready: boolean;
              }[];
              project_id: string;
              projections: {
                  atom_strategies: string[];
                  created_timestamp: string;
                  hyperparameters: Record<string, never>;
                  id: string;
                  og_image?: string;
                  projection_name: string;
                  ready: boolean;
                  thumbnail?: string;
                  updated_timestamp: string;
              }[];
              updated_timestamp: string;
          }[];
          created_timestamp: string;
          creator: string;
          creator_nickname: string;
          creator_picture: string;
          description: string;
          id: string;
          insert_update_delete_lock: boolean;
          is_public: boolean;
          is_public_to_org: boolean;
          modality?: string;
          og_image: string;
          organization_name: string;
          organization_slug: string;
          owner: string;
          permissions: {
              dataset:administration:read: boolean;
              dataset:administration:write: boolean;
              dataset:data:read: boolean;
              dataset:data:write: boolean;
              dataset:members:read: boolean;
              dataset:members:write: boolean;
              dataset:metadata:read: boolean;
              dataset:metadata:write: boolean;
              dataset:tags:read: boolean;
              dataset:tags:write: boolean;
          };
          project_fields: string[];
          project_name: string;
          schema?: string;
          slug: string;
          total_datums_in_project: number;
          unique_id_field: string;
      }

      Type declaration

      • access_role: string

        Access Role

        Description

        Access role of user for this project

      • atlas_indices: {
            atoms: string[];
            colorable_fields: string[];
            created_timestamp: string;
            embedders: {
                atlas_index_id: string;
                hyperparameters: Record<string, never>;
                id: string;
                model_name: string;
                ready: boolean;
            }[];
            id: string;
            index_name: string;
            indexed_field: string;
            nearest_neighbor_indices: {
                atom_strategies: string[];
                hyperparameters: Record<string, never>;
                id: string;
                index_name: string;
                ready: boolean;
            }[];
            project_id: string;
            projections: {
                atom_strategies: string[];
                created_timestamp: string;
                hyperparameters: Record<string, never>;
                id: string;
                og_image?: string;
                projection_name: string;
                ready: boolean;
                thumbnail?: string;
                updated_timestamp: string;
            }[];
            updated_timestamp: string;
        }[]

        Atlas Indices

        Description

        All Atlas Indices built overtop of this project.

        @@ -93,24 +93,24 @@

        Example

        example_projec
         

        Description

        Total datums in project.

      • unique_id_field: string

        Unique Id Field

        Description

        The field that contains a unique id for each document.

        -
      _index?: AtlasIndex
      _project?: AtlasProject

      A projection is a map in Atlas; it represents a snapshot 2d view of a dataset +

      _index?: AtlasIndex
      _project?: AtlasProject

      A projection is a map in Atlas; it represents a snapshot 2d view of a dataset at a point in time. Every projection belongs to a Dataset.

      -
      _schema: null | Uint8Array = null
      attributePromise: undefined | Promise<{
          access_role: string;
          atlas_indices: {
              atoms: string[];
              colorable_fields: string[];
              created_timestamp: string;
              embedders: {
                  atlas_index_id: string;
                  hyperparameters: Record<string, never>;
                  id: string;
                  model_name: string;
                  ready: boolean;
              }[];
              id: string;
              index_name: string;
              indexed_field: string;
              nearest_neighbor_indices: {
                  atom_strategies: string[];
                  hyperparameters: Record<string, never>;
                  id: string;
                  index_name: string;
                  ready: boolean;
              }[];
              project_id: string;
              projections: {
                  atom_strategies: string[];
                  created_timestamp: string;
                  hyperparameters: Record<string, never>;
                  id: string;
                  og_image?: string;
                  projection_name: string;
                  ready: boolean;
                  thumbnail?: string;
                  updated_timestamp: string;
              }[];
              updated_timestamp: string;
          }[];
          created_timestamp: string;
          creator: string;
          creator_nickname: string;
          creator_picture: string;
          description: string;
          id: string;
          insert_update_delete_lock: boolean;
          is_public: boolean;
          is_public_to_org: boolean;
          modality?: string;
          og_image: string;
          organization_name: string;
          organization_slug: string;
          owner: string;
          permissions: {
              dataset:administration:read: boolean;
              dataset:administration:write: boolean;
              dataset:data:read: boolean;
              dataset:data:write: boolean;
              dataset:members:read: boolean;
              dataset:members:write: boolean;
              dataset:metadata:read: boolean;
              dataset:metadata:write: boolean;
              dataset:tags:read: boolean;
              dataset:tags:write: boolean;
          };
          project_fields: string[];
          project_name: string;
          schema?: string;
          slug: string;
          total_datums_in_project: number;
          unique_id_field: string;
      }>
      id: string

      The UUID of the projection to retrieve.

      -
      project_id: string
      viewer: AtlasViewer

      Accessors

      • get attr(): undefined | AttributesType
      • returns the object's information; this may be undefined

        -

        Returns undefined | AttributesType

      • get quadtree_root(): string
      • Returns string

        the URL for the quadtree root for this projection. +

      _schema: null | Uint8Array = null
      attributePromise: undefined | Promise<{
          access_role: string;
          atlas_indices: {
              atoms: string[];
              colorable_fields: string[];
              created_timestamp: string;
              embedders: {
                  atlas_index_id: string;
                  hyperparameters: Record<string, never>;
                  id: string;
                  model_name: string;
                  ready: boolean;
              }[];
              id: string;
              index_name: string;
              indexed_field: string;
              nearest_neighbor_indices: {
                  atom_strategies: string[];
                  hyperparameters: Record<string, never>;
                  id: string;
                  index_name: string;
                  ready: boolean;
              }[];
              project_id: string;
              projections: {
                  atom_strategies: string[];
                  created_timestamp: string;
                  hyperparameters: Record<string, never>;
                  id: string;
                  og_image?: string;
                  projection_name: string;
                  ready: boolean;
                  thumbnail?: string;
                  updated_timestamp: string;
              }[];
              updated_timestamp: string;
          }[];
          created_timestamp: string;
          creator: string;
          creator_nickname: string;
          creator_picture: string;
          description: string;
          id: string;
          insert_update_delete_lock: boolean;
          is_public: boolean;
          is_public_to_org: boolean;
          modality?: string;
          og_image: string;
          organization_name: string;
          organization_slug: string;
          owner: string;
          permissions: {
              dataset:administration:read: boolean;
              dataset:administration:write: boolean;
              dataset:data:read: boolean;
              dataset:data:write: boolean;
              dataset:members:read: boolean;
              dataset:members:write: boolean;
              dataset:metadata:read: boolean;
              dataset:metadata:write: boolean;
              dataset:tags:read: boolean;
              dataset:tags:write: boolean;
          };
          project_fields: string[];
          project_name: string;
          schema?: string;
          slug: string;
          total_datums_in_project: number;
          unique_id_field: string;
      }>
      id: string

      The UUID of the projection to retrieve.

      +
      project_id: string
      viewer: AtlasViewer

      Accessors

      • get attr(): undefined | AttributesType
      • returns the object's information; this may be undefined

        +

        Returns undefined | AttributesType

      • get quadtree_root(): string
      • Returns string

        the URL for the quadtree root for this projection. 'public' may be be added in fetching.

        -

      Methods

      • Parameters

        • endpoint: string
        • method: "GET" | "POST"
        • payload: Payload = null
        • headers: null | Record<string, string> = null

        Returns Promise<null | string | any[] | Record<string, any> | Uint8Array | Table<any>>

      • Parameters

        • ids: string[] | number[] | bigint[]

        Returns Promise<any>

      • Parameters

        • options: CreateTagOptions

        Returns Promise<TagResponse>

      • Parameters

        • options: DeleteTagRequest

        Returns Promise<void>

      • Fetches basic information about the object. +

      Methods

      • Parameters

        • endpoint: string
        • method: "GET" | "POST"
        • payload: Payload = null
        • headers: null | Record<string, string> = null

        Returns Promise<null | string | any[] | Record<string, any> | Uint8Array | Table<any>>

      • Parameters

        • ids: number[] | string[] | bigint[]

        Returns Promise<any>

      • Parameters

        • options: CreateTagOptions

        Returns Promise<TagResponse>

      • Parameters

        • options: DeleteTagRequest

        Returns Promise<void>

      • Fetches basic information about the object. By default, this caches the call; if you want to bust the cache, pass true as the first argument. This immediately.

        Parameters

        • bustCache: boolean = false

          Whether to refetch the relevant information

        Returns Promise<{
            access_role: string;
            atlas_indices: {
                atoms: string[];
                colorable_fields: string[];
                created_timestamp: string;
                embedders: {
                    atlas_index_id: string;
                    hyperparameters: Record<string, never>;
                    id: string;
                    model_name: string;
                    ready: boolean;
                }[];
                id: string;
                index_name: string;
                indexed_field: string;
                nearest_neighbor_indices: {
                    atom_strategies: string[];
                    hyperparameters: Record<string, never>;
                    id: string;
                    index_name: string;
                    ready: boolean;
                }[];
                project_id: string;
                projections: {
                    atom_strategies: string[];
                    created_timestamp: string;
                    hyperparameters: Record<string, never>;
                    id: string;
                    og_image?: string;
                    projection_name: string;
                    ready: boolean;
                    thumbnail?: string;
                    updated_timestamp: string;
                }[];
                updated_timestamp: string;
            }[];
            created_timestamp: string;
            creator: string;
            creator_nickname: string;
            creator_picture: string;
            description: string;
            id: string;
            insert_update_delete_lock: boolean;
            is_public: boolean;
            is_public_to_org: boolean;
            modality?: string;
            og_image: string;
            organization_name: string;
            organization_slug: string;
            owner: string;
            permissions: {
                dataset:administration:read: boolean;
                dataset:administration:write: boolean;
                dataset:data:read: boolean;
                dataset:data:write: boolean;
                dataset:members:read: boolean;
                dataset:members:write: boolean;
                dataset:metadata:read: boolean;
                dataset:metadata:write: boolean;
                dataset:tags:read: boolean;
                dataset:tags:write: boolean;
            };
            project_fields: string[];
            project_name: string;
            schema?: string;
            slug: string;
            total_datums_in_project: number;
            unique_id_field: string;
        }>

        A promise that resolves to the organization info.

        -
      • Parameters

        • options: TagRequestOptions

        Returns Promise<TagStatus>

      • Parameters

        • param0: Omit<{
              atlas_index_id: string;
              k?: number;
              queries: string | number[][];
          }, "atlas_index_id">

          an object with keys k (number of numbers) and queries (list of vectors, where each one is the length of the embedding space).

          +
      • Parameters

        • options: TagRequestOptions

        Returns Promise<TagStatus>

      • Parameters

        • param0: Omit<{
              atlas_index_id: string;
              k?: number;
              queries: string | number[][];
          }, "atlas_index_id">

          an object with keys k (number of numbers) and queries (list of vectors, where each one is the length of the embedding space).

        Returns Promise<Record<string, any>>

        A list of entries in sorted order, where each entry is a list of neighbors including distances in the _distance field.

        -
      • Parameters

        • options: RoboTagOptions

        Returns Promise<void>

      • Parameters

        • options: UpdateTagOptions

        Returns Promise<TagResponse>

      • Parameters

        • bitmask_bytes: Uint8Array
        • options: UpdateTagMaskOptions

        Returns Promise<void>

      • Loads the information associated with the class, removing any +

      • Parameters

        • options: RoboTagOptions

        Returns Promise<void>

      • Parameters

        • options: UpdateTagOptions

        Returns Promise<TagResponse>

      • Parameters

        • bitmask_bytes: Uint8Array
        • options: UpdateTagMaskOptions

        Returns Promise<void>

      • Loads the information associated with the class, removing any existing caches.

        Returns Promise<LoadedObject<AtlasProjection, {
            access_role: string;
            atlas_indices: {
                atoms: string[];
                colorable_fields: string[];
                created_timestamp: string;
                embedders: {
                    atlas_index_id: string;
                    hyperparameters: Record<string, never>;
                    id: string;
                    model_name: string;
                    ready: boolean;
                }[];
                id: string;
                index_name: string;
                indexed_field: string;
                nearest_neighbor_indices: {
                    atom_strategies: string[];
                    hyperparameters: Record<string, never>;
                    id: string;
                    index_name: string;
                    ready: boolean;
                }[];
                project_id: string;
                projections: {
                    atom_strategies: string[];
                    created_timestamp: string;
                    hyperparameters: Record<string, never>;
                    id: string;
                    og_image?: string;
                    projection_name: string;
                    ready: boolean;
                    thumbnail?: string;
                    updated_timestamp: string;
                }[];
                updated_timestamp: string;
            }[];
            created_timestamp: string;
            creator: string;
            creator_nickname: string;
            creator_picture: string;
            description: string;
            id: string;
            insert_update_delete_lock: boolean;
            is_public: boolean;
            is_public_to_org: boolean;
            modality?: string;
            og_image: string;
            organization_name: string;
            organization_slug: string;
            owner: string;
            permissions: {
                dataset:administration:read: boolean;
                dataset:administration:write: boolean;
                dataset:data:read: boolean;
                dataset:data:write: boolean;
                dataset:members:read: boolean;
                dataset:members:write: boolean;
                dataset:metadata:read: boolean;
                dataset:metadata:write: boolean;
                dataset:tags:read: boolean;
                dataset:tags:write: boolean;
            };
            project_fields: string[];
            project_name: string;
            schema?: string;
            slug: string;
            total_datums_in_project: number;
            unique_id_field: string;
        }>>

        a LoadedObject instance of the class that is guaranteed to have its attr slot populated with appropriate information.

        Example

        const loadedProject = await (new AtlasProject(projectId)).withLoadedAttributes()

        // OR, in cases where we want to do stuff immediately with the project and ensure
        // that later calls there don't double-fetch information.

        const project = new AtlasProject(projectId)

        // do stuff right away.
        const projection = new AtlasProjection(projectionId, {project: project})
        const loadedProjection = await projection.withLoadedAttributes()
        // do stuff with loadedProjection
        -
      \ No newline at end of file +
      \ No newline at end of file diff --git a/classes/AtlasUser.html b/classes/AtlasUser.html index 36180ab..4868f37 100644 --- a/classes/AtlasUser.html +++ b/classes/AtlasUser.html @@ -1,4 +1,4 @@ -AtlasUser | @nomic-ai/atlas

      Hierarchy

      • BaseAtlasClass<UserInfo>
        • AtlasUser

      Constructors

      constructor +AtlasUser | @nomic-ai/atlas

      Hierarchy

      • BaseAtlasClass<UserInfo>
        • AtlasUser

      Constructors

      • Parameters

        • Rest ...args: [params: AnonViewerLogin]

        Returns AtlasUser

      Properties

      _attr: undefined | UserInfo
      attributePromise: undefined | Promise<UserInfo>
      viewer: AtlasViewer

      Accessors

      • get attr(): undefined | AttributesType
      • returns the object's information; this may be undefined

        -

        Returns undefined | AttributesType

      Methods

      • Parameters

        • endpoint: string
        • method: "GET" | "POST"
        • payload: Payload = null
        • headers: null | Record<string, string> = null

        Returns Promise<null | string | any[] | Record<string, any> | Uint8Array | Table<any>>

      • Returns string

      • Fetches basic information about the object. +

      Constructors

      • Parameters

        • Rest ...args: [params: AnonViewerLogin]

        Returns AtlasUser

      Properties

      _attr: undefined | UserInfo
      attributePromise: undefined | Promise<UserInfo>
      viewer: AtlasViewer

      Accessors

      • get attr(): undefined | AttributesType
      • returns the object's information; this may be undefined

        +

        Returns undefined | AttributesType

      Methods

      • Parameters

        • endpoint: string
        • method: "GET" | "POST"
        • payload: Payload = null
        • headers: null | Record<string, string> = null

        Returns Promise<null | string | any[] | Record<string, any> | Uint8Array | Table<any>>

      • Returns string

      • Fetches basic information about the object. By default, this caches the call; if you want to bust the cache, pass true as the first argument. This immediately.

        Parameters

        • bustCache: boolean = false

          Whether to refetch the relevant information

        Returns Promise<UserInfo>

        A promise that resolves to the organization info.

        -
      • Parameters

        • role: null | "OWNER" | "MEMBER" = null

          return only organizations where the user has this role (default: null, return all organizations)

          +
      • Parameters

        • role: null | "OWNER" | "MEMBER" = null

          return only organizations where the user has this role (default: null, return all organizations)

        Returns Promise<AtlasOrganization[]>

        A list of organizations where the user has the specified role

        -
      • Returns Promise<{
            created_timestamp: string;
            creator: string;
            creator_nickname: string;
            creator_picture: string;
            description: string;
            id: string;
            is_public: boolean;
            is_public_to_org: boolean;
            modality?: string;
            nickname: string;
            organization_name: string;
            organization_slug: string;
            owner: string;
            project_fields: string[];
            project_name: string;
            slug: string;
            thumbnail: string;
            total_datums_in_project: number;
            unique_id_field: string;
        }[]>

        All projects that the user has access to.

        -
      • Loads the information associated with the class, removing any +

      • Returns Promise<{
            created_timestamp: string;
            creator: string;
            creator_nickname: string;
            creator_picture: string;
            description: string;
            id: string;
            is_public: boolean;
            is_public_to_org: boolean;
            modality?: string;
            nickname: string;
            organization_name: string;
            organization_slug: string;
            owner: string;
            project_fields: string[];
            project_name: string;
            slug: string;
            thumbnail: string;
            total_datums_in_project: number;
            unique_id_field: string;
        }[]>

        All projects that the user has access to.

        +
      • Loads the information associated with the class, removing any existing caches.

        Returns Promise<LoadedObject<AtlasUser, UserInfo>>

        a LoadedObject instance of the class that is guaranteed to have its attr slot populated with appropriate information.

        Example

        const loadedProject = await (new AtlasProject(projectId)).withLoadedAttributes()

        // OR, in cases where we want to do stuff immediately with the project and ensure
        // that later calls there don't double-fetch information.

        const project = new AtlasProject(projectId)

        // do stuff right away.
        const projection = new AtlasProjection(projectionId, {project: project})
        const loadedProjection = await projection.withLoadedAttributes()
        // do stuff with loadedProjection
        -
      \ No newline at end of file +
      \ No newline at end of file diff --git a/classes/AtlasViewer.html b/classes/AtlasViewer.html index c31f6e7..2c3587a 100644 --- a/classes/AtlasViewer.html +++ b/classes/AtlasViewer.html @@ -1,4 +1,4 @@ -AtlasViewer | @nomic-ai/atlas

      Constructors

      constructor +AtlasViewer | @nomic-ai/atlas

      Constructors

      Properties

      anonymous apiLocation credentials @@ -11,10 +11,10 @@ TokenLogin: Uses a bearer token or Nomic API key. must have token: string AnonUser: No credentials, used for anonymous Viewer

      -

      Parameters

      • params: Envlogin

      Returns AtlasViewer

    • Parameters

      • params: ApiKeyLogin

      Returns AtlasViewer

    • Parameters

      • params: BearerTokenLogin

      Returns AtlasViewer

    • Parameters

      • params: AnonViewerLogin

      Returns AtlasViewer

    • Properties

      anonymous: boolean = false
      apiLocation: string
      credentials: Promise<null | Credentials>

      Methods

      Properties

      anonymous: boolean = false
      apiLocation: string
      credentials: Promise<null | Credentials>

      Methods

      • Call the API and return the results as deserialized JSON or Arrow.

        Parameters

        • endpoint: string

          The nomic API endpoint to call. If it doesn't begin with a slash, it will be added.

        • method: "GET" | "POST" = 'GET'

          POST or GET

        • payload: Payload = null

          The binary or JSON payload sent with the request.

        • headers: null | Record<string, string> = null

          Additional headers to send with the request

          -
        • options: ApiCallOptions = ...

        Returns Promise<null | string | any[] | Record<string, any> | Uint8Array | Table<any>>

      \ No newline at end of file +
    • options: ApiCallOptions = ...
    • Returns Promise<null | string | any[] | Record<string, any> | Uint8Array | Table<any>>

      \ No newline at end of file diff --git a/classes/Embedder.html b/classes/Embedder.html index 206d7aa..c9f4646 100644 --- a/classes/Embedder.html +++ b/classes/Embedder.html @@ -14,7 +14,7 @@

      BAD -- You will generate many small, inefficient requests.

       * const documents = ["Once upon a time", "there was a girl named Goldilocks", …, "and they all lived happily ever after"]
      const embedder = new Embedder(myApiKey)
      const embeddings = []
      for (let document of documents) {
      const embedding = await embedder.embed(document); // <- premature await.
      embeddings.push(embedding);
      }
      -

      Hierarchy

      Constructors

      Hierarchy

      • BaseAtlasClass<{}>
        • Embedder

      Constructors

      Properties

      _attr: undefined | {}

      Type declaration

        attributePromise: undefined | Promise<{}>
        backoff: null | number = null
        embedQueue: [string, ((embedding) => void), ((error) => void)][] = []
        epitaph?: Error
        model: EmbeddingModel
        nextScheduledFlush: unknown = null
        taskType: TaskType
        tokensUsed: number = 0
        viewer: AtlasViewer

        Accessors

        • get attr(): undefined | AttributesType
        • returns the object's information; this may be undefined

          -

          Returns undefined | AttributesType

        Methods

        • Parameters

          • values: string[]

          Returns Promise<NomicEmbedResponse>

        • Parameters

          • endpoint: string
          • method: "GET" | "POST"
          • payload: Payload = null
          • headers: null | Record<string, string> = null

          Returns Promise<null | string | any[] | Record<string, any> | Uint8Array | Table<any>>

        • Parameters

          • value: string

          Returns Promise<Embedding>

        • Parameters

          • value: string[]

          Returns Promise<Embedding[]>

        • Fetches basic information about the object. +

        • options: EmbedderOptions

        Returns Embedder

      • Parameters

        Returns Embedder

      • Parameters

        Returns Embedder

      • Properties

        _attr: undefined | {}

        Type declaration

          attributePromise: undefined | Promise<{}>
          backoff: null | number = null
          embedQueue: [string, ((embedding) => void), ((error) => void)][] = []
          epitaph?: Error
          model: EmbeddingModel
          nextScheduledFlush: unknown = null
          taskType: TaskType
          tokensUsed: number = 0
          viewer: AtlasViewer

          Accessors

          • get attr(): undefined | AttributesType
          • returns the object's information; this may be undefined

            +

            Returns undefined | AttributesType

          Methods

          • Parameters

            • values: string[]

            Returns Promise<NomicEmbedResponse>

          • Parameters

            • endpoint: string
            • method: "GET" | "POST"
            • payload: Payload = null
            • headers: null | Record<string, string> = null

            Returns Promise<null | string | any[] | Record<string, any> | Uint8Array | Table<any>>

          • Parameters

            • value: string

            Returns Promise<Embedding>

          • Parameters

            • value: string[]

            Returns Promise<Embedding[]>

          • Fetches basic information about the object. By default, this caches the call; if you want to bust the cache, pass true as the first argument. This immediately.

            Parameters

            • bustCache: boolean = false

              Whether to refetch the relevant information

            Returns Promise<{}>

            A promise that resolves to the organization info.

            -
          • Loads the information associated with the class, removing any +

          • Loads the information associated with the class, removing any existing caches.

            Returns Promise<LoadedObject<Embedder, {}>>

            a LoadedObject instance of the class that is guaranteed to have its attr slot populated with appropriate information.

            Example

            const loadedProject = await (new AtlasProject(projectId)).withLoadedAttributes()

            // OR, in cases where we want to do stuff immediately with the project and ensure
            // that later calls there don't double-fetch information.

            const project = new AtlasProject(projectId)

            // do stuff right away.
            const projection = new AtlasProjection(projectionId, {project: project})
            const loadedProjection = await projection.withLoadedAttributes()
            // do stuff with loadedProjection
            -
          \ No newline at end of file +
          \ No newline at end of file diff --git a/functions/embed.html b/functions/embed.html index 2c4c429..97628ba 100644 --- a/functions/embed.html +++ b/functions/embed.html @@ -1 +1 @@ -embed | @nomic-ai/atlas

          Function embed

          • Parameters

            • value: string
            • options: EmbedderOptions
            • apiKey: undefined | string

            Returns Promise<Embedding>

          • Parameters

            • values: string[]
            • options: EmbedderOptions
            • apiKey: undefined | string

            Returns Promise<Embedding[]>

          \ No newline at end of file +embed | @nomic-ai/atlas

          Function embed

          • Parameters

            • value: string
            • options: EmbedderOptions
            • apiKey: undefined | string

            Returns Promise<Embedding>

          • Parameters

            • values: string[]
            • options: EmbedderOptions
            • apiKey: undefined | string

            Returns Promise<Embedding[]>

          \ No newline at end of file