Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Masukan File Manifest untuk Pekerjaan Pelabelan Cloud Point 3D
Saat membuat pekerjaan pelabelan, Anda menyediakan file manifes masukan di mana setiap baris manifes menjelaskan unit tugas yang harus diselesaikan oleh anotator. Format file manifes masukan Anda bergantung pada jenis tugas Anda.
+ Jika Anda membuat **deteksi objek** awan titik 3D atau pekerjaan pelabelan **segmentasi semantik**, setiap baris dalam file manifes input Anda berisi informasi tentang satu bingkai awan titik 3D. Ini disebut *manifes input frame titik awan*. Untuk mempelajari selengkapnya, lihat [Buat File Manifes Input Point Cloud Frame](sms-point-cloud-single-frame-input-data.md).
+ Jika Anda membuat pekerjaan pelabelan **pelacakan objek** cloud titik 3D, setiap baris file manifes masukan Anda berisi urutan bingkai awan titik 3D dan data terkait. Ini disebut *manifes input urutan awan titik*. Untuk mempelajari selengkapnya, lihat [Buat Manifes Input Urutan Awan Titik](sms-point-cloud-multi-frame-input-data.md).
# Buat File Manifes Input Point Cloud Frame
Manifes adalah file yang dikodekan UTF-8 di mana setiap baris adalah objek JSON yang lengkap dan valid. Setiap baris dibatasi oleh jeda baris standar,\$1natau\$1 r\$1n. Karena setiap baris harus menjadi objek JSON yang valid, Anda tidak dapat memiliki karakter pemisah baris yang tidak terlolos. Dalam file manifes input bingkai tunggal, setiap baris dalam manifes berisi data untuk bingkai awan titik tunggal. Data frame awan titik dapat disimpan dalam format biner atau ASCII (lihat[Format Data 3D Mentah yang Diterima](sms-point-cloud-raw-data-types.md)). Ini adalah format file manifes yang diperlukan untuk deteksi objek cloud titik 3D dan segmentasi semantik. Secara opsional, Anda juga dapat menyediakan data fusi sensor kamera untuk setiap frame cloud titik.
Ground Truth mendukung fusi sensor point cloud dan kamera video dalam [sistem koordinat dunia](sms-point-cloud-sensor-fusion-details.md#sms-point-cloud-world-coordinate-system) untuk semua modalitas. Jika Anda dapat memperoleh sensor 3D ekstrinsik (seperti ekstrinsik LiDAR), kami sarankan Anda mengubah bingkai awan titik 3D menjadi sistem koordinat dunia menggunakan ekstrinsik. Untuk informasi selengkapnya, lihat [Sensor Fusion](sms-point-cloud-sensor-fusion-details.md#sms-point-cloud-sensor-fusion).
Namun, jika Anda tidak dapat memperoleh awan titik di sistem koordinat dunia, Anda dapat memberikan koordinat dalam sistem koordinat asli tempat data ditangkap. Jika Anda menyediakan data kamera untuk fusi sensor, Anda disarankan untuk menyediakan sensor LiDAR dan pose kamera di sistem koordinat dunia.
Untuk membuat file manifes input bingkai tunggal, Anda akan mengidentifikasi lokasi setiap frame cloud titik yang ingin diberi label oleh pekerja menggunakan `source-ref` kunci. Selain itu, Anda harus menggunakan `source-ref-metadata` kunci untuk mengidentifikasi format kumpulan data Anda, stempel waktu untuk bingkai itu, dan, secara opsional, data fusi sensor dan gambar kamera video.
Contoh berikut menunjukkan sintaks yang digunakan untuk file manifes masukan untuk pekerjaan pelabelan cloud titik bingkai tunggal. Contohnya mencakup dua titik cloud frame. Untuk detail tentang setiap parameter, lihat tabel berikut contoh ini.
**penting**
Setiap baris dalam file manifes masukan Anda harus dalam format [JSON Lines](http://jsonlines.org/). Blok kode berikut menunjukkan file manifes masukan dengan dua objek JSON. Setiap objek JSON digunakan untuk menunjuk dan memberikan rincian tentang bingkai awan titik tunggal. Objek JSON telah diperluas untuk keterbacaan, tetapi Anda harus meminimalkan setiap objek JSON agar sesuai pada satu baris saat membuat file manifes input. Contoh disediakan di bawah blok kode ini.
```
{
"source-ref": "s3://amzn-s3-demo-bucket/examplefolder/frame1.bin",
"source-ref-metadata":{
"format": "binary/xyzi",
"unix-timestamp": 1566861644.759115,
"ego-vehicle-pose":{
"position": {
"x": -2.7161461413869947,
"y": 116.25822288149078,
"z": 1.8348751887989483
},
"heading": {
"qx": -0.02111296123795955,
"qy": -0.006495469416730261,
"qz": -0.008024565904865688,
"qw": 0.9997181192298087
}
},
"prefix": "s3://amzn-s3-demo-bucket/lidar_singleframe_dataset/someprefix/",
"images": [
{
"image-path": "images/frame300.bin_camera0.jpg",
"unix-timestamp": 1566861644.759115,
"fx": 847.7962624528487,
"fy": 850.0340893791985,
"cx": 576.2129134707038,
"cy": 317.2423573573745,
"k1": 0,
"k2": 0,
"k3": 0,
"k4": 0,
"p1": 0,
"p2": 0,
"skew": 0,
"position": {
"x": -2.2722515189268138,
"y": 116.86003310568965,
"z": 1.454614668542299
},
"heading": {
"qx": 0.7594754093069037,
"qy": 0.02181790885672969,
"qz": -0.02461725233103356,
"qw": -0.6496916273040025
},
"camera-model": "pinhole"
}]
}
}
{
"source-ref": "s3://amzn-s3-demo-bucket/examplefolder/frame2.bin",
"source-ref-metadata":{
"format": "binary/xyzi",
"unix-timestamp": 1566861632.759133,
"ego-vehicle-pose":{
"position": {
"x": -2.7161461413869947,
"y": 116.25822288149078,
"z": 1.8348751887989483
},
"heading": {
"qx": -0.02111296123795955,
"qy": -0.006495469416730261,
"qz": -0.008024565904865688,
"qw": 0.9997181192298087
}
},
"prefix": "s3://amzn-s3-demo-bucket/lidar_singleframe_dataset/someprefix/",
"images": [
{
"image-path": "images/frame300.bin_camera0.jpg",
"unix-timestamp": 1566861644.759115,
"fx": 847.7962624528487,
"fy": 850.0340893791985,
"cx": 576.2129134707038,
"cy": 317.2423573573745,
"k1": 0,
"k2": 0,
"k3": 0,
"k4": 0,
"p1": 0,
"p2": 0,
"skew": 0,
"position": {
"x": -2.2722515189268138,
"y": 116.86003310568965,
"z": 1.454614668542299
},
"heading": {
"qx": 0.7594754093069037,
"qy": 0.02181790885672969,
"qz": -0.02461725233103356,
"qw": -0.6496916273040025
},
"camera-model": "pinhole"
}]
}
}
```
Saat Anda membuat file manifes masukan, Anda harus menciutkan objek JSON Anda agar sesuai dengan satu baris. Misalnya, blok kode di atas akan muncul sebagai berikut dalam file manifes masukan:
```
{"source-ref":"s3://amzn-s3-demo-bucket/examplefolder/frame1.bin","source-ref-metadata":{"format":"binary/xyzi","unix-timestamp":1566861644.759115,"ego-vehicle-pose":{"position":{"x":-2.7161461413869947,"y":116.25822288149078,"z":1.8348751887989483},"heading":{"qx":-0.02111296123795955,"qy":-0.006495469416730261,"qz":-0.008024565904865688,"qw":0.9997181192298087}},"prefix":"s3://amzn-s3-demo-bucket/lidar_singleframe_dataset/someprefix/","images":[{"image-path":"images/frame300.bin_camera0.jpg","unix-timestamp":1566861644.759115,"fx":847.7962624528487,"fy":850.0340893791985,"cx":576.2129134707038,"cy":317.2423573573745,"k1":0,"k2":0,"k3":0,"k4":0,"p1":0,"p2":0,"skew":0,"position":{"x":-2.2722515189268138,"y":116.86003310568965,"z":1.454614668542299},"heading":{"qx":0.7594754093069037,"qy":0.02181790885672969,"qz":-0.02461725233103356,"qw":-0.6496916273040025},"camera-model":"pinhole"}]}}
{"source-ref":"s3://amzn-s3-demo-bucket/examplefolder/frame2.bin","source-ref-metadata":{"format":"binary/xyzi","unix-timestamp":1566861632.759133,"ego-vehicle-pose":{"position":{"x":-2.7161461413869947,"y":116.25822288149078,"z":1.8348751887989483},"heading":{"qx":-0.02111296123795955,"qy":-0.006495469416730261,"qz":-0.008024565904865688,"qw":0.9997181192298087}},"prefix":"s3://amzn-s3-demo-bucket/lidar_singleframe_dataset/someprefix/","images":[{"image-path":"images/frame300.bin_camera0.jpg","unix-timestamp":1566861644.759115,"fx":847.7962624528487,"fy":850.0340893791985,"cx":576.2129134707038,"cy":317.2423573573745,"k1":0,"k2":0,"k3":0,"k4":0,"p1":0,"p2":0,"skew":0,"position":{"x":-2.2722515189268138,"y":116.86003310568965,"z":1.454614668542299},"heading":{"qx":0.7594754093069037,"qy":0.02181790885672969,"qz":-0.02461725233103356,"qw":-0.6496916273040025},"camera-model":"pinhole"}]}}
```
Tabel berikut menunjukkan parameter yang dapat Anda sertakan dalam file manifes masukan Anda:
****
| Parameter | Diperlukan | Nilai yang Diterima | Deskripsi |
| --- | --- | --- | --- |
| `source-ref` | Ya | String **Format nilai string yang diterima**: `s3:////point-cloud-frame-file` | Lokasi Amazon S3 dari bingkai awan titik tunggal. |
| `source-ref-metadata` | Ya | Objek JSON **Parameter yang diterima**: `format`, `unix-timestamp`, `ego-vehicle-pose`, `position`, `prefix`, `images` | Gunakan parameter ini untuk menyertakan informasi tambahan tentang titik awan di`source-ref`, dan untuk menyediakan data kamera untuk fusi sensor. |
| `format` | Tidak | String **Nilai string yang diterima**: `"binary/xyz"``"binary/xyzi"`,`"binary/xyzrgb"`,`"binary/xyzirgb"`,`"text/xyz"`,`"text/xyzi"`,`"text/xyzrgb"`, `"text/xyzirgb"` **Nilai Default**: Ketika file yang diidentifikasi `source-ref` memiliki ekstensi.bin, `binary/xyzi` Ketika file yang diidentifikasi `source-ref` memiliki ekstensi.txt, `text/xyzi` | Gunakan parameter ini untuk menentukan format data cloud titik Anda. Untuk informasi selengkapnya, lihat [Format Data 3D Mentah yang Diterima](sms-point-cloud-raw-data-types.md). |
| `unix-timestamp` | Ya | Bilangan Stempel waktu unix. | Stempel waktu unix adalah jumlah detik sejak 1 Januari 1970 hingga waktu UTC bahwa data dikumpulkan oleh sensor. |
| `ego-vehicle-pose` | Tidak | Objek JSON | Pose perangkat yang digunakan untuk mengumpulkan data titik cloud. Untuk informasi selengkapnya tentang parameter ini, lihat[Sertakan Informasi Pose Kendaraan dalam Manifes Input Anda](#sms-point-cloud-single-frame-ego-vehicle-input). |
| `prefix` | Tidak | String **Format nilai string yang diterima**: `s3:////` | Lokasi di Amazon S3 tempat metadata Anda, seperti gambar kamera, disimpan untuk bingkai ini. Awalan harus diakhiri dengan garis miring:. `/` |
| `images` | Tidak | Daftar | Daftar parameter yang menggambarkan gambar kamera berwarna yang digunakan untuk fusi sensor. Anda dapat menyertakan hingga 8 gambar dalam daftar ini. Untuk informasi selengkapnya tentang parameter yang diperlukan untuk setiap gambar, lihat[Sertakan Data Kamera dalam Manifes Input Anda](#sms-point-cloud-single-frame-image-input). |
## Sertakan Informasi Pose Kendaraan dalam Manifes Input Anda
Gunakan lokasi kendaraan ego untuk memberikan informasi tentang lokasi kendaraan yang digunakan untuk menangkap data titik cloud. Ground Truth menggunakan informasi ini untuk menghitung matriks ekstrinsik LiDAR.
Ground Truth menggunakan matriks ekstrinsik untuk memproyeksikan label ke dan dari adegan 3D dan gambar 2D. Untuk informasi selengkapnya, lihat [Sensor Fusion](sms-point-cloud-sensor-fusion-details.md#sms-point-cloud-sensor-fusion).
Tabel berikut memberikan informasi lebih lanjut tentang parameter `position` dan orientasi (`heading`) yang diperlukan saat Anda memberikan informasi kendaraan ego.
****
| Parameter | Diperlukan | Nilai yang Diterima | Deskripsi |
| --- | --- | --- | --- |
| `position` | Ya | Objek JSON **Parameter yang Diperlukan**: `x`, `y`, dan `z`. Masukkan angka untuk parameter ini. | Vektor terjemahan kendaraan ego dalam sistem koordinat dunia. |
| `heading` | Ya | Objek JSON **Parameter yang Diperlukan**: `qx`, `qy`, `qz`, dan `qw`. Masukkan angka untuk parameter ini. | Orientasi kerangka acuan perangkat atau sensor yang dipasang pada kendaraan yang merasakan sekitarnya, diukur dalam [kuaternion](https://en.wikipedia.org/wiki/Quaternion), (,, `qx` `qy``qz`,`qw`) dalam sistem koordinat. |
## Sertakan Data Kamera dalam Manifes Input Anda
Jika Anda ingin menyertakan data kamera video dengan bingkai, gunakan parameter berikut untuk memberikan informasi tentang setiap gambar. Kolom **Diperlukan** di bawah ini berlaku ketika `images` parameter disertakan dalam file manifes masukan di bawah`source-ref-metadata`. Anda tidak diharuskan untuk menyertakan gambar dalam file manifes masukan Anda.
Jika Anda menyertakan gambar kamera, Anda harus menyertakan informasi tentang kamera `position` dan `heading` menggunakan pengambilan gambar dalam sistem koordinat dunia.
Jika gambar Anda terdistorsi, Ground Truth dapat secara otomatis membatalkan distorsi mereka menggunakan informasi yang Anda berikan tentang gambar dalam file manifes input Anda, termasuk koefisien distorsi (,`k1`,,,,,`p1`) `k2` `k3` `k4``p1`, model kamera dan matriks intrinsik kamera. Matriks intrinsik terdiri dari panjang fokus (`fx`,`fy`), dan titik utama (`cx`,. `cy)` Lihat [Matriks Intrinsik](sms-point-cloud-sensor-fusion-details.md#sms-point-cloud-intrinsic) untuk mempelajari bagaimana Ground Truth menggunakan kamera intrinsik. Jika koefisien distorsi tidak disertakan, Ground Truth tidak akan merusak gambar.
****
| Parameter | Diperlukan | Nilai yang Diterima | Deskripsi |
| --- | --- | --- | --- |
| `image-path` | Ya | String **Contoh format**: `/` | Lokasi relatif, di Amazon S3 file gambar Anda. Jalur relatif ini akan ditambahkan ke jalur yang Anda tentukan. `prefix` |
| `unix-timestamp` | Ya | Bilangan | Stempel waktu unix adalah jumlah detik sejak 1 Januari 1970 hingga waktu UTC bahwa data dikumpulkan oleh kamera. |
| `camera-model` | Tidak | Tali: **Nilai yang Diterima**: `"pinhole"`, `"fisheye"` **Default**: `"pinhole"` | Model kamera yang digunakan untuk menangkap gambar. Informasi ini digunakan untuk mengubah gambar kamera. |
| `fx, fy` | Ya | Nomor | Panjang fokus kamera, dalam arah x (`fx`) dan y (`fy`). |
| `cx, cy` | Ya | Nomor | Koordinat x (`cx``cy`) dan y () dari titik utama. |
| `k1, k2, k3, k4` | Tidak | Bilangan | Koefisien distorsi radial. Didukung untuk model **kamera mata ikan** dan **lubang jarum**. |
| `p1, p2` | Tidak | Bilangan | Koefisien distorsi tangensial. Didukung untuk model kamera **lubang jarum**. |
| `skew` | Tidak | Bilangan | Parameter untuk mengukur kemiringan gambar. |
| `position` | Ya | Objek JSON **Parameter yang Diperlukan**: `x`, `y`, dan `z`. Masukkan angka untuk parameter ini. | Lokasi atau asal kerangka acuan kamera yang dipasang pada kendaraan yang menangkap gambar. |
| `heading` | Ya | Objek JSON **Parameter yang Diperlukan**: `qx`, `qy`, `qz`, dan `qw`. Masukkan angka untuk parameter ini. | Orientasi kerangka acuan kamera yang dipasang pada kendaraan yang menangkap gambar, diukur menggunakan [kuaternion](https://en.wikipedia.org/wiki/Quaternion), (,,,`qw`) `qx` `qy``qz`, dalam sistem koordinat dunia. |
## Batas Bingkai Awan Titik
Anda dapat menyertakan hingga 100.000 titik cloud frame dalam file manifes masukan Anda. Pekerjaan pelabelan cloud titik 3D memiliki waktu pra-pemrosesan yang lebih lama daripada jenis tugas Ground Truth lainnya. Untuk informasi selengkapnya, lihat [Waktu pra-pemrosesan pekerjaan](sms-point-cloud-general-information.md#sms-point-cloud-job-creation-time).
# Buat Manifes Input Urutan Awan Titik
Manifes adalah file yang dikodekan UTF-8 di mana setiap baris adalah objek JSON yang lengkap dan valid. Setiap baris dibatasi oleh jeda baris standar,\$1natau\$1 r\$1n. Karena setiap baris harus menjadi objek JSON yang valid, Anda tidak dapat memiliki karakter pemisah baris yang tidak terlolos. Dalam file manifes masukan urutan awan titik, setiap baris dalam manifes berisi urutan bingkai awan titik. Data awan titik untuk setiap frame dalam urutan dapat disimpan dalam format biner atau ASCII. Untuk informasi selengkapnya, lihat [Format Data 3D Mentah yang Diterima](sms-point-cloud-raw-data-types.md). Ini adalah format file manifes yang diperlukan untuk pelacakan objek cloud titik 3D. Secara opsional, Anda juga dapat memberikan atribut titik dan data fusi sensor kamera untuk setiap bingkai awan titik. Saat Anda membuat file manifes input urutan, Anda harus menyediakan data fusi sensor kamera LiDAR dan video dalam sistem [koordinat dunia](sms-point-cloud-sensor-fusion-details.md#sms-point-cloud-world-coordinate-system).
Contoh berikut menunjukkan sintaks yang digunakan untuk file manifes masukan ketika setiap baris dalam manifes adalah file urutan. Setiap baris dalam file manifes masukan Anda harus dalam format [JSON Lines](http://jsonlines.org/).
```
{"source-ref": "s3://amzn-s3-demo-bucket/example-folder/seq1.json"}
{"source-ref": "s3://amzn-s3-demo-bucket/example-folder/seq2.json"}
```
Data untuk setiap urutan frame awan titik perlu disimpan dalam objek data JSON. Berikut ini adalah contoh format yang Anda gunakan untuk file urutan. Informasi tentang setiap frame disertakan sebagai objek JSON dan tercantum dalam `frames` daftar. Ini adalah contoh file urutan dengan file frame cloud dua titik, `frame300.bin` dan`frame303.bin`. *...*Ini digunakan untuk menunjukkan di mana Anda harus menyertakan informasi untuk bingkai tambahan. Tambahkan objek JSON untuk setiap frame dalam urutan.
Blok kode berikut mencakup objek JSON untuk file urutan tunggal. Objek JSON telah diperluas untuk keterbacaan.
```
{
"seq-no": 1,
"prefix": "s3://amzn-s3-demo-bucket/example_lidar_sequence_dataset/seq1/",
"number-of-frames": 100,
"frames":[
{
"frame-no": 300,
"unix-timestamp": 1566861644.759115,
"frame": "example_lidar_frames/frame300.bin",
"format": "binary/xyzi",
"ego-vehicle-pose":{
"position": {
"x": -2.7161461413869947,
"y": 116.25822288149078,
"z": 1.8348751887989483
},
"heading": {
"qx": -0.02111296123795955,
"qy": -0.006495469416730261,
"qz": -0.008024565904865688,
"qw": 0.9997181192298087
}
},
"images": [
{
"image-path": "example_images/frame300.bin_camera0.jpg",
"unix-timestamp": 1566861644.759115,
"fx": 847.7962624528487,
"fy": 850.0340893791985,
"cx": 576.2129134707038,
"cy": 317.2423573573745,
"k1": 0,
"k2": 0,
"k3": 0,
"k4": 0,
"p1": 0,
"p2": 0,
"skew": 0,
"position": {
"x": -2.2722515189268138,
"y": 116.86003310568965,
"z": 1.454614668542299
},
"heading": {
"qx": 0.7594754093069037,
"qy": 0.02181790885672969,
"qz": -0.02461725233103356,
"qw": -0.6496916273040025
},
"camera-model": "pinhole"
}]
},
{
"frame-no": 303,
"unix-timestamp": 1566861644.759115,
"frame": "example_lidar_frames/frame303.bin",
"format": "text/xyzi",
"ego-vehicle-pose":{...},
"images":[{...}]
},
...
]
}
```
Tabel berikut memberikan rincian tentang parameter tingkat atas dari file urutan. Untuk informasi rinci tentang parameter yang diperlukan untuk frame individu dalam file urutan, lihat[Parameter untuk Bingkai Awan Titik Individu](#sms-point-cloud-multi-frame-input-single-frame).
****
| Parameter | Diperlukan | Nilai yang Diterima | Deskripsi |
| --- | --- | --- | --- |
| `seq-no` | Ya | Bilangan Bulat | Nomor urutan yang diurutkan. |
| `prefix` | Ya | String **Nilai yang Diterima**: `s3:////` | Lokasi Amazon S3 tempat file urutan berada. Awalan harus diakhiri dengan garis miring:. `/` |
| `number-of-frames` | Ya | Bilangan Bulat | Jumlah total frame yang termasuk dalam file urutan. Angka ini harus sesuai dengan jumlah frame yang tercantum dalam `frames` parameter di baris berikutnya. |
| `frames` | Ya | Daftar objek JSON | Daftar data bingkai. Panjang daftar harus sama`number-of-frames`. Di UI pekerja, frame dalam urutan akan sama dengan urutan frame dalam array ini. Untuk detail tentang format setiap frame, lihat[Parameter untuk Bingkai Awan Titik Individu](#sms-point-cloud-multi-frame-input-single-frame). |
## Parameter untuk Bingkai Awan Titik Individu
Tabel berikut menunjukkan parameter yang dapat Anda sertakan dalam file manifes masukan Anda.
****
| Parameter | Diperlukan | Nilai yang Diterima | Deskripsi |
| --- | --- | --- | --- |
| `frame-no` | Tidak | Bilangan Bulat | Nomor bingkai. Ini adalah pengidentifikasi opsional yang ditentukan oleh pelanggan untuk mengidentifikasi bingkai dalam urutan. Ini tidak digunakan oleh Ground Truth. |
| `unix-timestamp` | Ya | Bilangan | Stempel waktu unix adalah jumlah detik sejak 1 Januari 1970 hingga waktu UTC bahwa data dikumpulkan oleh sensor. Stempel waktu untuk setiap frame harus berbeda dan stempel waktu harus berurutan karena digunakan untuk interpolasi berbentuk kubus. Idealnya, ini harus menjadi stempel waktu nyata ketika data dikumpulkan. Jika ini tidak tersedia, Anda harus menggunakan urutan tambahan stempel waktu, di mana bingkai pertama dalam file urutan Anda sesuai dengan stempel waktu pertama dalam urutan. |
| `frame` | Ya | String **Contoh format** `/` | Lokasi relatif, di Amazon S3 dari file urutan Anda. Jalur relatif ini akan ditambahkan ke jalur yang Anda tentukan. `prefix` |
| `format` | Tidak | String **Nilai string yang diterima**: `"binary/xyz"``"binary/xyzi"`,`"binary/xyzrgb"`,`"binary/xyzirgb"`,`"text/xyz"`,`"text/xyzi"`,`"text/xyzrgb"`, `"text/xyzirgb"` **Nilai Default**: Ketika file yang diidentifikasi `source-ref` memiliki ekstensi.bin, `binary/xyzi` Ketika file yang diidentifikasi `source-ref` memiliki ekstensi.txt, `text/xyzi` | Gunakan parameter ini untuk menentukan format data cloud titik Anda. Untuk informasi selengkapnya, lihat [Format Data 3D Mentah yang Diterima](sms-point-cloud-raw-data-types.md). |
| `ego-vehicle-pose` | Tidak | Objek JSON | Pose perangkat yang digunakan untuk mengumpulkan data titik cloud. Untuk informasi selengkapnya tentang parameter ini, lihat[Sertakan Informasi Pose Kendaraan dalam Manifes Input Anda](#sms-point-cloud-multi-frame-ego-vehicle-input). |
| `prefix` | Tidak | String **Format nilai string yang diterima**: `s3:////` | Lokasi di Amazon S3 tempat metadata Anda, seperti gambar kamera, disimpan untuk bingkai ini. Awalan harus diakhiri dengan garis miring:. `/` |
| `images` | Tidak | Daftar | Daftar parameter yang menggambarkan gambar kamera berwarna yang digunakan untuk fusi sensor. Anda dapat menyertakan hingga 8 gambar dalam daftar ini. Untuk informasi selengkapnya tentang parameter yang diperlukan untuk setiap gambar, lihat[Sertakan Data Kamera dalam Manifes Input Anda](#sms-point-cloud-multi-frame-image-input). |
## Sertakan Informasi Pose Kendaraan dalam Manifes Input Anda
Gunakan lokasi kendaraan ego untuk memberikan informasi tentang pose kendaraan yang digunakan untuk menangkap data titik cloud. Ground Truth menggunakan informasi ini untuk menghitung matriks ekstrinsik LiDAR.
Ground Truth menggunakan matriks ekstrinsik untuk memproyeksikan label ke dan dari adegan 3D dan gambar 2D. Untuk informasi selengkapnya, lihat [Sensor Fusion](sms-point-cloud-sensor-fusion-details.md#sms-point-cloud-sensor-fusion).
Tabel berikut memberikan informasi lebih lanjut tentang parameter `position` dan orientasi (`heading`) yang diperlukan saat Anda memberikan informasi kendaraan ego.
****
| Parameter | Diperlukan | Nilai yang Diterima | Deskripsi |
| --- | --- | --- | --- |
| `position` | Ya | Objek JSON **Parameter yang Diperlukan**: `x`, `y`, dan `z`. Masukkan angka untuk parameter ini. | Vektor terjemahan kendaraan ego dalam sistem koordinat dunia. |
| `heading` | Ya | Objek JSON **Parameter yang Diperlukan**: `qx`, `qy`, `qz`, dan `qw`. Masukkan angka untuk parameter ini. | Orientasi kerangka acuan perangkat atau sensor yang dipasang pada kendaraan yang merasakan sekitarnya, diukur dalam [kuaternion](https://en.wikipedia.org/wiki/Quaternion), (,, `qx` `qy``qz`,`qw`) dalam sistem koordinat. |
## Sertakan Data Kamera dalam Manifes Input Anda
Jika Anda ingin menyertakan data kamera berwarna dengan bingkai, gunakan parameter berikut untuk memberikan informasi tentang setiap gambar. Kolom **Diperlukan** dalam tabel berikut berlaku ketika `images` parameter disertakan dalam file manifes masukan. Anda tidak diharuskan untuk menyertakan gambar dalam file manifes masukan Anda.
Jika Anda menyertakan gambar kamera, Anda harus menyertakan informasi tentang `position` dan orientasi (`heading`) kamera yang digunakan untuk menangkap gambar.
Jika gambar Anda terdistorsi, Ground Truth dapat secara otomatis membatalkan distorsi mereka menggunakan informasi yang Anda berikan tentang gambar dalam file manifes masukan Anda, termasuk koefisien distorsi (`k1`,,,`k2`,`k3`,`p1`) `k4``p1`, model kamera dan panjang fokus (,`fy`)`fx`, dan titik utama (,. `cx` `cy)` Untuk mempelajari lebih lanjut tentang koefisien dan gambar yang tidak terdistorsi ini, lihat [Kalibrasi](https://docs.opencv.org/2.4.13.7/doc/tutorials/calib3d/camera_calibration/camera_calibration.html) kamera Dengan OpenCV. Jika koefisien distorsi tidak disertakan, Ground Truth tidak akan merusak gambar.
****
| Parameter | Diperlukan | Nilai yang Diterima | Deskripsi |
| --- | --- | --- | --- |
| `image-path` | Ya | String **Contoh format**: `/` | Lokasi relatif, di Amazon S3 file gambar Anda. Jalur relatif ini akan ditambahkan ke jalur yang Anda tentukan. `prefix` |
| `unix-timestamp` | Ya | Bilangan | Stempel waktu gambar. |
| `camera-model` | Tidak | Tali: **Nilai yang Diterima**: `"pinhole"`, `"fisheye"` **Default**: `"pinhole"` | Model kamera yang digunakan untuk menangkap gambar. Informasi ini digunakan untuk mengubah gambar kamera. |
| `fx, fy` | Ya | Nomor | Panjang fokus kamera, dalam arah x (`fx`) dan y (`fy`). |
| `cx, cy` | Ya | Nomor | Koordinat x (`cx``cy`) dan y () dari titik utama. |
| `k1, k2, k3, k4` | Tidak | Bilangan | Koefisien distorsi radial. Didukung untuk model **kamera mata ikan** dan **lubang jarum**. |
| `p1, p2` | Tidak | Bilangan | Koefisien distorsi tangensial. Didukung untuk model kamera **lubang jarum**. |
| `skew` | Tidak | Bilangan | Parameter untuk mengukur kemiringan yang diketahui pada gambar. |
| `position` | Ya | Objek JSON **Parameter yang Diperlukan**: `x`, `y`, dan `z`. Masukkan angka untuk parameter ini. | Lokasi atau asal kerangka acuan kamera yang dipasang pada kendaraan yang menangkap gambar. |
| `heading` | Ya | Objek JSON **Parameter yang Diperlukan**: `qx`, `qy`, `qz`, dan `qw`. Masukkan angka untuk parameter ini. | Orientasi kerangka acuan kamera yang dipasang pada kendaraan yang menangkap gambar, diukur menggunakan [kuaternion](https://en.wikipedia.org/wiki/Quaternion), (,,`qx`,`qy`). `qz` `qw` |
## File Urutan dan Batas Bingkai Awan Titik
Anda dapat menyertakan hingga 100.000 urutan bingkai awan titik dalam file manifes masukan Anda. Anda dapat menyertakan hingga 500 titik cloud frame di setiap file urutan.
Perlu diingat bahwa pekerjaan pelabelan cloud titik 3D memiliki waktu pra-pemrosesan yang lebih lama daripada jenis tugas Ground Truth lainnya. Lihat informasi yang lebih lengkap di [Waktu pra-pemrosesan pekerjaan](sms-point-cloud-general-information.md#sms-point-cloud-job-creation-time).