Population of models

1. Overview

이 지침서는 당신이 SDF tag 을 이용해서 어떻게 모델을 복제를 할수있지를 보여줍니다. 복제는 고유의 모델모음으로 구성이 되어있습니다.

모델복제는 다음의 파라메타를 정합니다.

1. 모델(예:테이블, 콜라병)
2. 복제를 원하는 오브젝트수
3. 오브젝트들이 배열될 형태와 디멘전(예:박스,실린더)
4. 복제 컨테이너의 위치와 방향
5. 콘테이너안에 오브젝트의 배포(예: 무작위,GRID) For reference, check the SDF specification for a complete specification of the tag and its parameters.

Creating an object population

Quick start

1. 이 지침서를 위해 디렉토리를 생성하는것으로 시작하세요

mkdir ~/tutorial_model_population
cd ~/tutorial_model_population

2. 이화일을 현재의 디렉토리에 다운로드 하세요 : can_population.world

wget http://bitbucket.org/osrf/gazebo_tutorials/raw/default/model_population/files/can_population.world

다인은 이 WORLD FILE을 얻어야 합니다. ``

<!-- A global light source -->
<include>
  <uri>model://sun</uri>
</include>

<!-- A ground plane -->
<include>
  <uri>model://ground_plane</uri>
</include>

<!-- Testing the automatic population of objects -->
<population name="can_population1">
  <model name="can1">
    <include>
      <static>true</static>
      <uri>model://coke_can</uri>
    </include>
  </model>
  <pose>0 0 0 0 0 0</pose>
  <box>
    <size>2 2 0.01</size>
  </box>
  <model_count>10</model_count>
  <distribution>
    <type>random</type>
  </distribution>
</population>

  3. 가제보를 실행합니다.

gazebo can_population.world

당신은 소다캔의 복제품을 보게됩니다( 랜덤으로 위치되어 있는)
이 캔들은 BOX 컨테이너 (2*2*2 미터)이내에 배열이 됩니다.

#The world explained
좀더 가봅시다. 다른 can_population.world 의 요소를 이해합니다.

<population name="can_population1">
  <model name="can1">
    <include>
      <static>true</static>
      <uri>model://coke_can</uri>
    </include>
  </model>

이 정보에서 우리는 <population> tag.를 이용해서 어떻게 복제품의 spec이 정해지는지 알수있습니다.
모든 복제품은 고유의 이름을 갖고있습니다.
이것은 이름속성으로 특정지어집니다.
복제태그 내에서, 당산은 model tag로 모델을 어떻게 선택하는지 알수있습니다.
각 복제품의 요소는 유일한 이름으로 시물레이션으로 삽입이 됩니다
이름은 _clone_i라는 이름으로 추가가 됨으로써 생성이 됩니다.
i는 복제요소의 순번 입니다.당신은 복제된 모델의 리스트를 볼수있습니다

![](https://bitbucket.org/osrf/gazebo_tutorials/raw/default/model_population/files/model_list_6-0.png)

가장 일반적인 복제 타입은 에니메이션이 않되는 오브젝트로 구성됩니다. 예를들면 나무,바위,빌딩등.
 We recommend you use the <population> tag for static models, and exclude mobile entities, such as robots, which often require more precise placement and are fewer in number.

0 0 0 0 0 0 2 2 0.01

위의 코드의 블럭은 지역을 특정화합니다, 그 직억은 오브젝트가 위치할 지역입니다.
이번 경우에서는, 모든 오브제그는 3d기초 박스(2 x 2 x 0.01 m, centered at (0, 0, 0) with orientation (0, 0, 0))에 복제되었습니다
 As an alternative to <box>, a <cylinder> region is also allowed by specifying its radius and length. (Check out the SDF specification for a full description of the <cylinder> parameters.) The <pose> element sets the reference frame of the population's region.

<model_count>10</model_count>

위에서 당신은 모델의 수를 볼수있습니다
어떤 양수이든 허용이 됩니다.
그러나 너무높은 수는 성능을 저하시킵니다.

  <distribution>
    <type>random</type>
  </distribution>

<distribution>은 오브젝트가 지역에 어떻게 배치가 되는지 설명합니다.

# Distribution types
  1. random : 무작위 위치로 복제됨
  2. uniform : 모델은 2d 패턴으로 위치합니다. 우리는 k-mean을 이용합니다. 지역내에 위치를 최적화 합니다.
  3. grid : 2d grid pattern에 위치합니다. 이 배포는 또한 당신이 rows nomber, col number, 엘리먼트사이 거리를 특정해야 합니다.
            이 <model_count> 는 이 배포에서 무시됩니다.
            오브젝트의 번호는 시물레이션에 삽입이 됩니다. 이 시물레이션은 행,열의 넘버와 같게됩니다.
  4. Linear -x : 모델은 x축을따라 row로 배치됩니다.
  4. Linear -y : 모델은 y축을따라 row로 배치됩니다.
  4. Linear -z : 모델은 z축을따라 row로 배치됩니다.
 
좀더 많은 진보된 예제를 당신은 population.world 에서 볼수있습니다.
그리고 물론 당신은 이것을 테스트해볼수 있습니다.

gazebo worlds/population.world

![](https://bitbucket.org/osrf/gazebo_tutorials/raw/default/model_population/files/gazebo_population.png)