search

TaiBIF / camera-trap-api

RESTful API
6 stars 3 forks source link

7.4 有效照片與目擊事件，7.5 初測延遲 v1 #173

Open ghost opened 5 years ago

ghost commented 5 years ago

把上個階段的資料計算兜起來。 spec 請參考 https://github.com/TaiBIF/camera-trap-api/issues/24 及舊版初測延遲 API spec 及 舊版有效照片與目擊事件 spec

已有的實作：https://github.com/TaiBIF/camera-trap-calculation (python based) AWS 亦有一台機器是為此而建。

ghost commented 5 years ago

建議：

  1. 從前端版型開始， 從這行瞭解前端最終是送出什麼格式的內容到舊版 API 的 /media/annotation/basic-calculation 及 /media/annotation/daily-first-captured
  2. 建議新版 endpoint: /calculations/basic 及 /calculations/latency-to-initial-detection
  3. 實作舊版功能到新版 API 中
  4. 注意這附近是丟到 Flask 的 API app (已在 AWS 跑起來)
ghost commented 5 years ago

@Kelp 這部分不知您瞭解多少？@Moogoo Li 還沒有開始，我可以看到大致上是上面幾件事，應該要如何分工？

kelp404 commented 5 years ago

還是我先做這個，前端的搜尋頁面 Jack 正在改，如果我也一起改的話很容易有衝突。

ghost commented 5 years ago

對啊 這個 issue 目前是 API 也缺

kelp404 commented 5 years ago

因為程式碼很難追而且怕有做錯的，所以想問一些功能上的定義。

有效照片與目擊事件

  1. 相機工作時數的定義是什麼。 資料不連續多久以後判定為相機沒在工作？例如兩筆資料間隔 8 小時的話算在工作時數中嗎？
  2. 「有效照片」僅篩選檔案是圖片的標註嗎？如果是影片的話也算進去嗎？
  3. 如果我將「有效時間判定間隔」與「目擊事件判定間隔」都一樣設定成三分鐘，「有效照片」跟「目擊事件」的數量會是一樣的嗎？
  4. 平均偵測天數比例的定義是什麼？
  5. 「有效照片除以相機工作時長」的單位應該是「照片/小時」，wireframe 是以「小時」為單位，確定是「小時」嗎？
  6. 「目擊事件除以相機工作時長」的單位應該是「事件/小時」，wireframe 是以「小時」為單位，確定是「小時」嗎？ 螢幕快照 2019-05-20 下午9 32 49

初測延遲

  1. 「起始日期」是日期還是時間？因為上面已經有一個「資料起始時間」了，我的認知是這個功能要計算每天「起始日期」的時間過後多久出現指定的物種。 螢幕快照 2019-05-20 下午9 47 56
kelp404 commented 5 years ago
資料計算
ghost commented 5 years ago

Screenshot 2019-05-21 11 09 53

這個 s3 bucket 是用來放計算資料的，也許在這版當中使用應該放在 camera-trap-api (prod) 及 camera-trap-api-dev (dev)，也就是 API 自己的 bucket 中。

舊版的設定在

https://github.com/TaiBIF/camera-trap-v0/blob/d9f034a4b07881a1456cc420628f7f56990ac8b0/common/models/multimedia-annotation.js#L614
ghost commented 5 years ago

RE: @kelp404

  1. 當天有資料就算工作一天
  2. 若有一段時間沒資料（不論幾天），就看篩選範圍內、前後相鄰的照片是否檔名序號連續，連續就視為中間那段時間有工作
  3. 若篩選範圍跨到沒資料的區間，也以區間外的第一張照片序號是否相連來決定該區間是否有工作