# 安装与快速入门

### 准备工作

1. 从私有化部署产品或者SAAS服务系统中创建好适合您需求的数据集。
2. 从系统中获取您用于身份认证使用的「AccessKey」。
3. 通过SDK可以对您的数据进行上传和读取的操作，并能使用数据集管理系统提供的数据格式对您的数据做可视化展示。

###

### 安装SDK

使用以下命令安装SDK：

```python
pip install testindata
```

{% hint style="info" %}
**使用本SDK须Python 3.6或更高版本。**
{% endhint %}

###

### 快速入门

```bash
from testindata.TDA import TDA

#Tkey 可以从系中对应的位置获取
AccessKey = "your_AccessKey"

#datasetId
datasetId = "ds_yourdatasetId"

#实例化TDA
tda = TDA(AccessKey, host="https://dataset.testin.cn/")

#设置要操作的数据集，如果您使用的是SAAS服务，无需设置ip，如果您使用的是私有化部署产品，则您需要指明您的数据集服务ip地址
tda.SetDataset(datasetId)
```

###

### 上传文件并添加可视化数据

云测数据数据集管理系统提供了数据可视化的功能，您可以将数据转换为系统规定的数据格式，并由sdk上传至系统，即可从系统中查看可视化的数据。

```python
from testindata.TDA import TDA

AccessKey = "0fbe149adf07e5f4afa01a7a4e787fde"
host = "xx.xx.xx.xx"

tda = TDA(AccessKey, host=host)

tda.Debug()

dataset = tda.SetDataset("ds_******")

metaData = {
    "metaKey1":"metaVal1",
    "metaKey2":"metaVal2",
    "metaKey3":"metaVal3",
}

file = tda.AddFile("/path/to/your/fileRootPath/11.jpg", referId="myTestRefId", metaData=metaData)

box = {
    "x": 10,
    "y": 10,
    "width": 100,
    "height": 100,
}

label = "myTestLabelName"

attr = {
    "attrKey1":"attrVal1",
    "attrKey2":"attrVal2",
    "attrKey3":"attrVal3",
}

file.AddBox2D(box, label=label, attrs=attr)

print(tda.Upload())

```

###

### 进入DEBUG模式

```python
tda = TDA(T_key, debug=True) 或者 tda.debug()
```

{% hint style="info" %}
在debug模式下，sdk会输出很多执行过程中的信息，以方便您监控整个程序的执行过程。
{% endhint %}

###

### 获取文件

获取文件存储信息

```python
filesData = tda.GetData(offset=1000, limit=1000)

for file in fileData["files"]:   
    print(file.fid)
    print(file.referId)
    print(file.meta)
    print(file.md5)
    print(file.path)
    
    for label in file.labeldata.labels:
        print(label)
```

{% hint style="info" %}
offset默认从0开始，limit最大值为1000
{% endhint %}

获取标注结果

```python
#根据fid 获取标注结果
file = tda.GetFileAndLabel(fid="fs_N7T02AgYJGF6yxAbk75R")

#根据ref_id获取标注结果
file = tda.GetFileAndLabel(ref_id="myreferId1")

print(file.fid)
print(file.referId)
print(file.meta)
print(file.md5)
print(file.path)

for label in file.labeldata.labels:
    print(label)

```

{% hint style="info" %}
fid 是数据集系统存储文件的唯一id，该id可以唯一定位一个上传文件；ref\_id是需要您自己维护的一个用于唯一定位资源的id，我们强烈建议您设置资源文件的ref\_id，用于关联您自己的业务系统。
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://testindata.gitbook.io/dataset/python-sdk/untitled.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.