Imgproc Services

Služba image

PUT - data obrazku
- PARAMS (volitelné - pokud nejsou zadány pokusí se systém dohledat jejich hodnoty v EXIF informaci o obrázku):
  - exp_time - čas ve kterém byl snímek pořízen, formát: yyyy-mm-dd,hh:mm:ss, příklad: 2004-06-24,06:21:22
  - exp_loc - pozice (GPS) na které byl snímek pořízen, formát: [N|S]dd.dd:mm.mm:ss.ss,[E|W]ddd.dd:mm.mm:ss.ss, příklad: N49.00:12.00:27.00,E017.00:35.00:43.00
- RETURN: state, image_uri
GET - PARAMS: image_uri
- RETURN: state, data obrazku
DELETE - PARAMS: image_uri
- RETURN: state

Služba video

PUT - data videa
- PARAMS (volitelné - pokud nejsou zadány nastaví se na implicitní hodnotu):
  - frame_step - počet snímků, mezi každým extrahovaným obrázkem
- PARAMS (volitelné - pokud nejsou zadány pokusí se systém dohledat jejich hodnoty v EXIF informaci o obrázku):
  - exp_time - čas ve kterém byl snímek pořízen, formát: yyyy-mm-dd,hh:mm:ss, příklad: 2004-06-24,06:21:22
  - exp_loc - pozice (GPS) na které byl snímek pořízen, formát: [N|S]dd.dd:mm.mm:ss.ss,[E|W]ddd.dd:mm.mm:ss.ss, příklad: N49.00:12.00:27.00,E017.00:35.00:43.00
- RETURN: state, video_uri, pocet snimku
GET - PARAMS: video_uri
- RETURN: state, data videa
DELETE - PARAMS: video_uri
- RETURN: state

Služba query

parametr q určuje typ dotazu
jednotlivé dotazy vrací XML

getResourceList

PARAMS:
- volitelně exp_time_from, exp_time_to - pokud jsou zadány, vrátí pouze výsledky odpovídající zadanému rozsahu časů; zdroje s nespecifikovaným časem pořízení nebudou vráceny
- volitně exp_loc[GPS], radius[m] - pokud jsou zadány, vrátí pouze výsledky odpovídající ležící v perimetru zadaném středem a poloměrem; zdroje s nespecifikovanou lokací pořízení nebudou vráceny
RETURN: list of resources uploaded to server

  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE xml SYSTEM "http://pcpribyl-b.fit.vutbr.cz/imgproc/dtd/resourceList.dtd">
  <xml>
    <query exp_time_from="2009-10-01 09:00:00" exp_time_to="2011-03-08 20:00:00" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04" radius="10000">getResourceList</query>
    <response>
       <resource uri="1.jpg" type="image" state="processed" exp_time="2009-12-08 09:09:22" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04">1.jpg</resource> 
       <resource uri="2.jpg" type="image" state="processed" exp_time="2009-12-08 09:09:22" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04">2.jpg</resource> 
       <resource uri="3.jpg" type="image" state="processed" exp_time="2009-12-08 09:09:22" exp_loc="">3.jpg</resource> 
       <resource uri="4.jpg" type="image" state="processed" exp_time="2009-12-08 09:09:22" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04">4.jpg</resource> 
       <resource uri="5.jpg" type="image" state="processed" exp_time="2009-12-08 09:09:22" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04">5.jpg</resource> 
       <resource uri="6.jpg" type="image" state="processed" exp_time="2009-12-08 09:09:22" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04">6.jpg</resource> 
       <resource uri="7.jpg" type="image" state="processed" exp_time="" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04">7.jpg</resource> 
       <resource uri="8.jpg" type="image" state="processed" exp_time="" exp_loc="">8.jpg</resource> 
       <resource uri="1.avi" type="video" state="processed" exp_time="2009-12-08 09:09:22" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04">1.avi</resource>
    </response>
  </xml>

getResourceState

PARAMS: resource_uri
RETURN: state, obj. count, segm. count (v podobe textu)
INFO: pokud je video, vrati seznam framu

  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE xml SYSTEM "http://pcpribyl-b.fit.vutbr.cz/imgproc/dtd/getResourceState.dtd">
  <xml>
    <query resource_uri="83.jpg">getResourceState</query>
    <response>
      <resource uri="83.jpg" state="3" video_uri="1.avi" video_pos="3000" exp_time="2009-12-08 09:09:22" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04" />
      <item name="segments">67</item>
      <item name="objects">15</item>
    </response>
  </xml>

  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE xml SYSTEM "http://pcpribyl-b.fit.vutbr.cz/imgproc/dtd/getResourceState.dtd">
  <xml>
    <query resource_uri="10.jpg">getResourceState</query>
    <response>
      <resource uri="10.jpg" state="3" exp_time="2009-12-08 09:09:21" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.02" />
      <item name="segments">15</item>
      <item name="objects">3</item>
    </response>
  </xml>
  
  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE xml SYSTEM "http://pcpribyl-b.fit.vutbr.cz/imgproc/dtd/getResourceState.dtd">
  <xml>
    <query resource_uri="83.avi">getResourceState</query>
    <response>
      <resource uri="83.avi" state="3" exp_time="2009-12-08 09:09:22" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04" />
      <frames count="3">
        <frame uri="83/1.jpg" video_pos="3000">83/1.jpg</frame>
        <frame uri="83/2.jpg" video_pos="3000">83/2.jpg</frame>
        <frame uri="83/3.jpg" video_pos="3000">83/3.jpg</frame>
      </frames>
    </response>
  </xml>

getSegments

PARAMS: resource_uri
RETURN: set of pairs: segment_type - percent
INFO: pro video zprůměrovat zastoupení segmentů v jednotlivých snímcích

  <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE xml SYSTEM "http://pcpribyl-b.fit.vutbr.cz/imgproc/dtd/getSegments.dtd">
  <xml>
    <query resource_uri="83.jpg">getSegments</query>
    <response>
      <resource uri="83.jpg" state="3" exp_time="2009-12-08 09:09:22" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04" />
      <item name="fire">0.15</item>
      <item name="grass">0.83</item>
    </response>
  </xml>

getObjects

PARAMS: resource_uri
RETURN: set of pairs: object_type - count
INFO: pro video zvolit maximální počet objektu

  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE xml SYSTEM "http://pcpribyl-b.fit.vutbr.cz/imgproc/dtd/getObjects.dtd">
  <xml>
    <query resource_uri="83.jpg">getObjects</query>
    <response>
      <resource uri="83.jpg" state="3" exp_time="2009-12-08 09:09:22" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04" />
      <item name="car_front">3</item>
      <item name="traffic_sign_column">5</item>
      <item name="pedestrian">8</item>
    </response>
  </xml>

isObjectInSegment

PARAMS
- resource_uri - je vynechán, vrátí seznam všech vyhovujících zdrojů
- segment_type
- object_type
- volitelně exp_time_from, exp_time_to - pokud jsou zadány, vrátí pouze výsledky odpovídající zadanému rozsahu časů; zdroje s nespecifikovaným časem pořízení nebudou vráceny
- volitně exp_loc[GPS], radius[m] - pokud jsou zadány, vrátí pouze výsledky odpovídající ležící v perimetru zadaném středem a poloměrem; zdroje s nespecifikovanou lokací pořízení nebudou vráceny
RETURN: TRUE, FALSE

  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE xml SYSTEM "http://pcpribyl-b.fit.vutbr.cz/imgproc/dtd/isObjectInSegment.dtd">
  <xml>
    <query resource_uri="83.jpg" object_type="pedestrian" segment_type="grass" exp_time_from="" exp_time_to="" exp_loc="" radius="">isObjectInSegment</query>
    <response>
      <resource uri="83.jpg" exp_time="2009-12-08 09:09:22" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04" />
      <result object_type="pedestrian" segment_type="grass">1</result>
    </response>
  </xml>

  Pokud je vynechán parametr resource_uri, vrátí seznam všech vyhovujících zdrojů:

  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE xml SYSTEM "http://pcpribyl-b.fit.vutbr.cz/imgproc/dtd/isObjectsInSegment.dtd">
  <xml>
    <query resource_uri="" object_type="car_side" segment_type="grass" exp_time_from="" exp_time_to="" exp_loc="" radius="">isObjectInSegment</query>
    <response>
      <resource uri="83.jpg" exp_time="2009-12-08 09:09:22" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04" />
      <result object_type="car_side" segment_type="grass">1</result>
    </response>
    <response>
      <resource uri="14.jpg" exp_time="2009-12-08 09:09:22" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04" />
      <result object_type="car_side" segment_type="grass">1</result>
    </response>
    ...
  </xml>

isSegmentAdjacent

PARAMS
- resource_uri - je vynechán, vrátí seznam všech vyhovujících zdrojů
- segment_type1
- segment_type2
- volitelně exp_time_from, exp_time_to - pokud jsou zadány, vrátí pouze výsledky odpovídající zadanému rozsahu časů; zdroje s nespecifikovaným časem pořízení nebudou vráceny
- volitně exp_loc[GPS], radius[m] - pokud jsou zadány, vrátí pouze výsledky odpovídající ležící v perimetru zadaném středem a poloměrem; zdroje s nespecifikovanou lokací pořízení nebudou vráceny
RETURN: TRUE, FALSE

  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE xml SYSTEM "http://pcpribyl-b.fit.vutbr.cz/imgproc/dtd/isSegmentAdjacent.dtd">
  <xml>
    <query resource_uri="83.jpg" segment_type1="road" segment_type2="water" exp_time_from="" exp_time_to="" exp_loc="" radius="">isSegmentAdjacent</query>
    <response>
      <resource uri="83.jpg" exp_time="2009-12-08 09:09:22" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04" />
      <result segment_type1="road" segment_type2="water">1</result>
    </response>
  </xml>

  Pokud je vynechán parametr resource_uri, vrátí seznam všech vyhovujících zdrojů:

  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE xml SYSTEM "http://pcpribyl-b.fit.vutbr.cz/imgproc/dtd/isSegmentAdjacent.dtd">
  <xml>
    <query resource_uri="" segment_type1="road" segment_type2="water" exp_time_from="" exp_time_to="" exp_loc="" radius="">isSegmentAdjacent</query>
    <response>
      <resource uri="2.avi" exp_time="2009-12-08 09:09:22" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04" />
      <result segment_type1="road" segment_type2="water">1</result>
    </response>
    <response>
      <resource uri="14.jpg" exp_time="2009-12-08 09:09:22" exp_loc="N50.00:27.00:31.32 E015.00:4.00:53.04" />
      <result segment_type1="road" segment_type2="water">1</result>
    </response>
    ...
  </xml>

tag

PARAMS
- resource_uri - pokud je vynechán, dotaz vrátí seznam všech vyhovujících zdrojů
- tag - určuje typ dotazovaného tagu
- volitelně exp_time_from, exp_time_to - pokud jsou zadány, vrátí pouze výsledky odpovídající zadanému rozsahu časů; zdroje s nespecifikovaným časem pořízení nebudou vráceny
- volitně exp_loc[GPS], radius[m] - pokud jsou zadány, vrátí pouze výsledky odpovídající ležící v perimetru zadaném středem a poloměrem; zdroje s nespecifikovanou lokací pořízení nebudou vráceny

RETURN: TRUE, FALSE

TAGS:
- car_in_fire
  - OBJECT(car_side | car_front) in SEGMENT(fire)
- car_in_water
  - OBJECT(car_side | car_front) in SEGMENT(water)
- fire
  - SEGMENT(fire) - minimal size of segment (25% of image area?)
- flood
  - (OBJECT(car_side | car_front | pedestrian | traffic_sign) in SEGMENT(water)) && !(SEGMENT(fire))
- man_in_water
  - OBJECT(pedestrian) in SEGMENT(water)

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE xml SYSTEM "http://pcpribyl-b.fit.vutbr.cz/imgproc/dtd/tag.dtd">
<xml>
   <query resource_uri="11.jpg" tag="fire" exp_time_from="" exp_time_to="" exp_loc="" radius="">tag</query>
   <response>
      <resource uri="11.jpg" exp_time="2011-03-11 19:23:09" exp_loc="N38.00:08.00:30.46 E140.00:54.00:46.04" />
      <result tag="fire">1</result>
   </response>
</xml>

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE xml SYSTEM "http://pcpribyl-b.fit.vutbr.cz/imgproc/dtd/tag.dtd">
<xml>
   <query resource_uri="" tag="fire" exp_time_from="" exp_time_to="" exp_loc="" radius="">tag</query>
   <response>
      <resource uri="1.avi" exp_time="" exp_loc="" />
      <result tag="fire">1</result>
   </response>
   <response>
      <resource uri="1.avi_1153.jpg" exp_time="" exp_loc="" />
      <result tag="fire">1</result>
   </response>
   ...
</xml>