Incomplete Information in Manual for 3D Task creation

[PWZING]

My actions before raising this issue

• Read/searched the docs
• Searched past issues
• Tested arround to get a 3D Task running

In the manuel there is no information about that the 3D data structures have to be zipped for the upload to CVAT. I tried around with all provided types of data structures at https://openvinotoolkit.github.io/cvat/docs/manual/basics/creating_an_annotation_task/#data-formats-for-a-3d-task and the task creation only works if the main folder of the data structure is zipped (e.g data.zip for 3D Option 1).

Furthermore I tried to create a 2D task alongside to a 3D task.
Obviously it's not possible to mix 2D task with 3D task (I checked the log of the cvat container an there is something about dimension check error of the tasks). In the manual I found no information about that.

The manual should be extended with this important informations.

Expected Behaviour

Current Behaviour

Possible Solution

Steps to Reproduce (for bugs)

1. Create the datastructures for 3D task accroding to manual.
2. Tried to upload them unzipped --> failed
3. Zip the folders and upload --> success

Context

Your Environment

• Git hash commit (git log -1):
  commit f915385 (HEAD -> develop, origin/develop, origin/HEAD)
  Author: AmitN1212 [email protected]
  Date: Fri Dec 31 07:08:00 2021 +0200

       Update documentation (Development Environment section) (#4082)
  

• Docker version docker version (e.g. Docker 17.0.05):
  Docker version 20.10.11, build dea9396

• Are you using Docker Swarm or Kubernetes?
  No

• Operating System and version (e.g. Linux, Windows, MacOS):
  Distributor ID: Ubuntu
  Description: Ubuntu 20.04.3 LTS
  Release: 20.04
  Codename: focal

• Code example or link to GitHub repo or gist to reproduce problem:

• Other diagnostic information / logs:

  Logs from `cvat` container

Dimension problem described above:

^[[36mcvat |^[[0m 2022-01-04 13:25:48,885 DEBG 'rqworker_default_0' stderr output:
^[[36mcvat |^[[0m INFO - 2022-01-04 13:25:48,885 - worker - default: cvat.apps.engine.task._create_thread(33, {'chunk_size': None, 'size': 0, 'image_quality': 70, 'start_frame': 0, 'sto...) (/api/v1/tasks/33)
^[[36mcvat |^[[0m
^[[36mcvat |^[[0m 2022-01-04 13:25:48,886 DEBG 'rqworker_default_0' stderr output:
^[[36mcvat |^[[0m DEBUG - 2022-01-04 13:25:48,886 - worker - Sent heartbeat to prevent worker timeout. Next one should arrive within 480 seconds.
^[[36mcvat |^[[0m
^[[36mcvat |^[[0m 2022-01-04 13:25:48,896 DEBG 'rqworker_default_0' stderr output:
^[[36mcvat |^[[0m DEBUG - 2022-01-04 13:25:48,895 - worker - Sent heartbeat to prevent worker timeout. Next one should arrive within 90 seconds.
^[[36mcvat |^[[0m
^[[36mcvat |^[[0m 2022-01-04 13:25:48,910 DEBG 'rqworker_default_0' stderr output:
^[[36mcvat |^[[0m [2022-01-04 13:25:48,910] INFO cvat.server: create task #33
^[[36mcvat |^[[0m
^[[36mcvat |^[[0m 2022-01-04 13:25:48,911 DEBG 'rqworker_default_0' stderr output:
^[[36mcvat |^[[0m INFO - 2022-01-04 13:25:48,910 - task - create task #33
^[[36mcvat |^[[0m
^[[36mcvat |^[[0m 2022-01-04 13:25:48,928 DEBG 'rqworker_default_0' stderr output:
^[[36mcvat |^[[0m DEBUG - 2022-01-04 13:25:48,928 - worker - Handling failed execution of job /api/v1/tasks/33
^[[36mcvat |^[[0m
^[[36mcvat |^[[0m 2022-01-04 13:25:48,929 DEBG 'rqworker_default_0' stderr output:
^[[36mcvat |^[[0m ERROR - 2022-01-04 13:25:48,929 - worker - Traceback (most recent call last):
^[[36mcvat |^[[0m File "/opt/venv/lib/python3.8/site-packages/rq/worker.py", line 936, in perform_job
^[[36mcvat |^[[0m rv = job.perform()
^[[36mcvat |^[[0m File "/opt/venv/lib/python3.8/site-packages/rq/job.py", line 684, in perform
^[[36mcvat |^[[0m self._result = self._execute()
^[[36mcvat |^[[0m File "/opt/venv/lib/python3.8/site-packages/rq/job.py", line 690, in _execute
^[[36mcvat |^[[0m return self.func(*self.args, **self.kwargs)
^[[36mcvat |^[[0m File "/usr/lib/python3.8/contextlib.py", line 75, in inner
^[[36mcvat |^[[0m return func(*args, **kwds)
^[[36mcvat |^[[0m File "/home/django/cvat/apps/engine/task.py", line 377, in _create_thread
^[[36mcvat |^[[0m raise Exception(f'Dimension ({validate_dimension.dimension}) of the task must be the same as other tasks in project ({db_task.project.tasks.first().dimension})')
^[[36mcvat |^[[0m Exception: Dimension (2d) of the task must be the same as other tasks in project (3d)
^[[36mcvat |^[[0m Traceback (most recent call last):
^[[36mcvat |^[[0m File "/opt/venv/lib/python3.8/site-packages/rq/worker.py", line 936, in perform_job
^[[36mcvat |^[[0m rv = job.perform()
^[[36mcvat |^[[0m File "/opt/venv/lib/python3.8/site-packages/rq/job.py", line 684, in perform
^[[36mcvat |^[[0m self._result = self._execute()
^[[36mcvat |^[[0m File "/opt/venv/lib/python3.8/site-packages/rq/job.py", line 690, in _execute
^[[36mcvat |^[[0m return self.func(*self.args, **self.kwargs)
^[[36mcvat |^[[0m File "/usr/lib/python3.8/contextlib.py", line 75, in inner
^[[36mcvat |^[[0m return func(*args, **kwds)
^[[36mcvat |^[[0m File "/home/django/cvat/apps/engine/task.py", line 377, in _create_thread
^[[36mcvat |^[[0m raise Exception(f'Dimension ({validate_dimension.dimension}) of the task must be the same as other tasks in project ({db_task.project.tasks.first().dimension})')
^[[36mcvat |^[[0m Exception: Dimension (2d) of the task must be the same as other tasks in project (3d)

Next steps

You may join our Gitter channel for community support.