Cognite Python SDK Documentation
This is the Cognite Python SDK for developers and data scientists working with Cognite Data Fusion (CDF). The package is tightly integrated with pandas, and helps you work easily and efficiently with data in Cognite Data Fusion (CDF).
Installation
To install this package:
pip install cognite-sdk
To upgrade the version of this package:
pip install cognite-sdk --upgrade
pip install "cognite-sdk[pandas, geo]"
Contents
- Quickstart
- Settings
- Credential Providers
- CogniteClient
CogniteClientClientConfigGlobalConfigGlobalConfig.default_client_configGlobalConfig.disable_gzipGlobalConfig.disable_pypi_version_checkGlobalConfig.status_forcelistGlobalConfig.max_retriesGlobalConfig.max_retries_connectGlobalConfig.max_retry_backoffGlobalConfig.max_connection_pool_sizeGlobalConfig.disable_sslGlobalConfig.proxies
- Extensions and optional dependencies
- Identity and access management
- Core Data Model
- Assets
- Retrieve an asset by id
- Retrieve multiple assets by id
- Retrieve an asset subtree
- List assets
- Aggregate assets
- Aggregate asset metadata keys
- Aggregate asset metadata values
- Aggregate Asset Count
- Aggregate Asset Value Cardinality
- Aggregate Asset Property Cardinality
- Aggregate Asset Unique Values
- Aggregate Asset Unique Properties
- Search for assets
- Create assets
- Create asset hierarchy
- Delete assets
- Filter assets
- Update assets
- Upsert assets
- Asset Data classes
- Events
- Retrieve an event by id
- Retrieve multiple events by id
- List events
- Aggregate events
- Aggregate Event Count
- Aggregate Event Values Cardinality
- Aggregate Event Property Cardinality
- Aggregate Event Unique Values
- Aggregate Event Unique Properties
- Search for events
- Create events
- Delete events
- Update events
- Upsert events
- Filter events
- Events Data classes
- Data points
- Retrieve datapoints
- Retrieve datapoints as numpy arrays
- Retrieve datapoints in pandas dataframe
- Retrieve datapoints in time zone in pandas dataframe
- Retrieve latest datapoint
- Insert data points
- Insert data points into multiple time series
- Insert pandas dataframe
- Delete a range of data points
- Delete ranges of data points
- Data Points Data classes
- Files
- Retrieve file metadata by id
- Retrieve multiple files’ metadata by id
- List files metadata
- Aggregate files metadata
- Search for files
- Create file metadata
- Upload a file or directory
- Upload a string or bytes
- Retrieve download urls
- Download files to disk
- Download a single file to a specific path
- Download a file as bytes
- Delete files
- Update files metadata
- Files Data classes
- Geospatial
- Create feature types
- Delete feature types
- List feature types
- Retrieve feature types
- Update feature types
- Create features
- Delete features
- Retrieve features
- Update features
- List features
- Search features
- Stream features
- Aggregate features
- Get coordinate reference systems
- List coordinate reference systems
- Create coordinate reference systems
- Put raster data
- Delete raster data
- Get raster data
- Compute
- Geospatial Data classes
CoordinateReferenceSystemCoordinateReferenceSystemListFeatureFeatureAggregateFeatureAggregateListFeatureListFeatureTypeFeatureTypeListFeatureTypePatchFeatureTypeUpdateGeospatialComputeFunctionGeospatialComputedItemGeospatialComputedItemListGeospatialComputedResponseGeospatialGeometryComputeFunctionGeospatialGeometryTransformComputeFunctionGeospatialGeometryValueComputeFunctionOrderSpecPatchesPropertyAndSearchSpecRasterMetadatanan_to_none()
- Synthetic time series
- Time series
- Retrieve a time series by id
- Retrieve multiple time series by id
- List time series
- Aggregate time series
- Aggregate Time Series Count
- Aggregate Time Series Values Cardinality
- Aggregate Time Series Property Cardinality
- Aggregate Time Series Unique Values
- Aggregate Time Series Unique Properties
- Search for time series
- Create time series
- Delete time series
- Filter time series
- Update time series
- Upsert time series
- Time Series Data classes
- Sequences
- Retrieve a sequence by id
- Retrieve multiple sequences by id
- List sequences
- Aggregate sequences
- Aggregate Sequences Count
- Aggregate Sequences Value Cardinality
- Aggregate Sequences Property Cardinality
- Aggregate Sequences Unique Values
- Aggregate Sequences Unique Properties
- Search for sequences
- Create a sequence
- Delete sequences
- Filter sequences
- Update sequences
- Upsert sequences
- Retrieve data
- Retrieve pandas dataframe
- Insert rows into a sequence
- Insert a pandas dataframe into a sequence
- Delete rows from a sequence
- Delete a range of rows from a sequence
- Sequence Data classes
- Data Point Subscriptions
- Create data point subscriptions
- Retrieve a data point subscription by id(s)
- List data point subscriptions
- List member time series of subscription
- Iterate over subscriptions data
- Update data point subscription
- Delete data point subscription
- Data Point Subscription classes
- Assets
- 3D
- Contextualization
- Entity Matching
- Engineering Diagrams
- Vision
- Extract
- Get vision extract job
- Contextualization Data Classes
AssetTagDetectionParametersContextualizationJobContextualizationJobListContextualizationJobList.append()ContextualizationJobList.clear()ContextualizationJobList.copy()ContextualizationJobList.count()ContextualizationJobList.dump()ContextualizationJobList.extend()ContextualizationJobList.get()ContextualizationJobList.index()ContextualizationJobList.insert()ContextualizationJobList.pop()ContextualizationJobList.remove()ContextualizationJobList.reverse()ContextualizationJobList.sort()ContextualizationJobList.to_pandas()
ContextualizationJobTypeDetectJobBundleDiagramConvertItemDiagramConvertPageDiagramConvertPageListDiagramConvertPageList.append()DiagramConvertPageList.clear()DiagramConvertPageList.copy()DiagramConvertPageList.count()DiagramConvertPageList.dump()DiagramConvertPageList.extend()DiagramConvertPageList.get()DiagramConvertPageList.index()DiagramConvertPageList.insert()DiagramConvertPageList.pop()DiagramConvertPageList.remove()DiagramConvertPageList.reverse()DiagramConvertPageList.sort()DiagramConvertPageList.to_pandas()
DiagramConvertResultsDiagramDetectItemDiagramDetectResultsDialGaugeDetectionDigitalGaugeDetectionEntityMatchingModelEntityMatchingModelListEntityMatchingModelList.append()EntityMatchingModelList.clear()EntityMatchingModelList.copy()EntityMatchingModelList.count()EntityMatchingModelList.dump()EntityMatchingModelList.extend()EntityMatchingModelList.get()EntityMatchingModelList.index()EntityMatchingModelList.insert()EntityMatchingModelList.pop()EntityMatchingModelList.remove()EntityMatchingModelList.reverse()EntityMatchingModelList.sort()EntityMatchingModelList.to_pandas()
EntityMatchingModelUpdateFeatureParametersFeatureParameters.asset_tag_detection_parametersFeatureParameters.dial_gauge_detection_parametersFeatureParameters.digital_gauge_detection_parametersFeatureParameters.dump()FeatureParameters.industrial_object_detection_parametersFeatureParameters.level_gauge_detection_parametersFeatureParameters.people_detection_parametersFeatureParameters.personal_protective_equipment_detection_parametersFeatureParameters.text_detection_parametersFeatureParameters.to_pandas()FeatureParameters.valve_detection_parameters
FileReferenceIndustrialObjectDetectionParametersJobStatusLevelGaugeDetectionPeopleDetectionParametersPersonalProtectiveEquipmentDetectionParametersResourceReferenceResourceReferenceListResourceReferenceList.append()ResourceReferenceList.clear()ResourceReferenceList.copy()ResourceReferenceList.count()ResourceReferenceList.dump()ResourceReferenceList.extend()ResourceReferenceList.get()ResourceReferenceList.index()ResourceReferenceList.insert()ResourceReferenceList.pop()ResourceReferenceList.remove()ResourceReferenceList.reverse()ResourceReferenceList.sort()ResourceReferenceList.to_pandas()
TextDetectionParametersThresholdParameterValveDetectionVisionExtractItemVisionExtractJobVisionExtractPredictionsVisionExtractPredictions.asset_tag_predictionsVisionExtractPredictions.dial_gauge_predictionsVisionExtractPredictions.digital_gauge_predictionsVisionExtractPredictions.dump()VisionExtractPredictions.industrial_object_predictionsVisionExtractPredictions.level_gauge_predictionsVisionExtractPredictions.people_predictionsVisionExtractPredictions.personal_protective_equipment_predictionsVisionExtractPredictions.text_predictionsVisionExtractPredictions.to_pandas()VisionExtractPredictions.valve_predictions
VisionFeatureVisionFeature.ASSET_TAG_DETECTIONVisionFeature.DIAL_GAUGE_DETECTIONVisionFeature.DIGITAL_GAUGE_DETECTIONVisionFeature.INDUSTRIAL_OBJECT_DETECTIONVisionFeature.LEVEL_GAUGE_DETECTIONVisionFeature.PEOPLE_DETECTIONVisionFeature.PERSONAL_PROTECTIVE_EQUIPMENT_DETECTIONVisionFeature.TEXT_DETECTIONVisionFeature.VALVE_DETECTIONVisionFeature.beta_features()
VisionJobAssetLinkKeypointCollectionKeypointCollectionWithObjectDetectionObjectDetectionTextRegionAttributeBoundingBoxCdfResourceRefKeypointPointPolygonPolylineVisionResource
- Documents
- Documents API
- Preview
- Data Ingestion
- Raw
- Extraction pipelines
- Extraction pipeline runs
- Extraction pipeline configs
- Get the latest or a specific config revision
- List configuration revisions
- Create a config revision
- Revert to an earlier config revision
- Extractor Config Data classes
- Data Organization
- Annotations
- Data sets
- Labels
- Relationships
- Transformations
- TransformationsAPI
- Transformation Schedules
- Transformation Notifications
- Transformation Jobs
- Transformation Schema
- Data classes
ContainsAnySessionDetailsTransformationTransformationFilterTransformationListTransformationPreviewResultTransformationUpdateTransformationScheduleTransformationScheduleListTransformationScheduleUpdateTransformationNotificationTransformationNotificationFilterTransformationNotificationListTransformationJobTransformationJobFilterTransformationJobListTransformationJobMetricTransformationJobMetricListTransformationJobStatusTransformationSchemaColumnTransformationSchemaColumnListEdgesInstancesNodesOidcCredentialsRawTableSequenceRowsTransformationBlockedInfoTransformationDestinationTransformationDestination.asset_hierarchy()TransformationDestination.assets()TransformationDestination.data_sets()TransformationDestination.datapoints()TransformationDestination.edges()TransformationDestination.events()TransformationDestination.files()TransformationDestination.instances()TransformationDestination.labels()TransformationDestination.nodes()TransformationDestination.raw()TransformationDestination.relationships()TransformationDestination.sequence_rows()TransformationDestination.sequences()TransformationDestination.string_datapoints()TransformationDestination.timeseries()
- Functions
- Data Modeling
- Data Models
- Spaces
- Views
- Retrieve views by id(s)
- List views
- Apply view
- Delete views
- View data classes
- Containers
- Retrieve containers by id(s)
- List containers
- Apply containers
- Delete containers
- Containers data classes
- Instances
- Retrieve instances by id(s)
- List instances
- Apply instances
- Search instances
- Aggregate instances
- Query instances
- Sync instances
- Delete instances
- Instances core data classes
EdgeEdgeApplyEdgeApplyListEdgeApplyResultEdgeApplyResultListEdgeListEdgeListWithCursorInstanceInstanceAggregationResultInstanceAggregationResultListInstanceApplyInstanceApplyResultInstanceCoreInstancesApplyInstancesApplyResultInstancesDeleteResultInstancesResultNodeNodeApplyNodeApplyListNodeApplyResultNodeApplyResultListNodeListNodeListWithCursorNodeOrEdgeDataPropertiesSubscriptionContext
- Instances query data classes
- Data Modeling Filtering data classes
AndCompoundFilterContainsAllContainsAnyEqualsExistsFilterFilterWithPropertyFilterWithPropertyAndValueFilterWithPropertyAndValueListGeoJSONGeoJSONDisjointGeoJSONIntersectsGeoJSONWithinHasDataInInAssetSubtreeMatchAllNestedNotOrOverlapsParameterValuePrefixPropertyReferenceValueRangeSearch
- Data Modeling ID data classes
- GraphQL
- Workflow Orchestration
- Workflows
- Workflow Versions
- Workflow Executions
- Workflow Tasks
- Update Status of Async Task
- Workflow Orchestration data classes
CDFTaskOutputCDFTaskParametersDynamicTaskOutputDynamicTaskParametersFunctionTaskOutputFunctionTaskParametersTransformationTaskOutputTransformationTaskParametersWorkflowWorkflowDefinitionWorkflowDefinitionUpsertWorkflowExecutionWorkflowExecutionDetailedWorkflowExecutionListWorkflowIdsWorkflowListWorkflowTaskWorkflowTaskExecutionWorkflowTaskOutputWorkflowTaskParametersWorkflowUpsertWorkflowVersionWorkflowVersionIdWorkflowVersionListWorkflowVersionUpsert
- Unit Catalog
- Deprecated
- Templates
- Create Template groups
- Upsert Template groups
- Retrieve Template groups
- List Template groups
- Delete Template groups
- Upsert a Template group version
- List Temple Group versions
- Delete a Temple Group version
- Run a GraphQL query
- Create Template instances
- Upsert Template instances
- Update Template instances
- Retrieve Template instances
- List Template instances
- Delete Template instances
- Create Template Views
- Upsert Template Views
- List Template Views
- Resolve Template View
- Delete Template Views
- Templates
- Base data classes
- Exceptions
- Utils
- Testing
- Appendix