README.md

Hands Detection Node

삼성SW청년아카데미 5기의 5FNSaaS팀에서 Node-red에 "동작인식"이라는 새로운 Node를 제시하고자 합니다. 다양한 기기의 제어는 일반적으로 터치와 음성으로 하는 경우가 많습니다. 하지만 이러한 방법이 제한되거나 자유롭게 사용하지 못하는 사용자들이 존재하며, 이러한 문제점을 해결하기 위해 "동작인식"이라는 추가적인 제어방법을 제안하게 되었습니다. 더 나아가, 5FNSaaS의 Node를 활용하면 신체의 정보를 활용하는 서비스의 Flow를 개발할 수 있습니다. 개발자가 이용하는 Node-red의 특성한 커스터마이징에 유용하도록 코드를 작성하였습니다.

Local Install

1. Node-Red 설치

npm install node-red -g

2. Hands Repository Clone

git clone https://github.com/5FNSaaS/Motion-Pose-Node-Hands.git

3. Node-Red에 Hands Detection Node 설치

npm install <clone_받은_경로>\Motion-Pose-Node-Hands

4. 명령프롬프트에서 실행하기

node-red

5. Node-red http://127.0.0.1:1880/ 접속해서 Hands 확인하기

hand-find

• input
  • multiHandLandmarks : media pipe hands 모델의 아웃풋. 각 손의 1~21번 포인트까지의 x,y,z 좌표값
  • mutiHandedness : media pipe hands 모델의 아웃풋. 각 손의 정보
  • savedLeftHand : db에 저장되어 있는 왼손 좌표의 json 배열들을 저장한 배열
  • savedRightHand : db에 저장되어 있는 오른손 좌표의 json 배열들을 저장한 배열
  • savedNameList : db에 저장되어 있는 손동작의 이름을 저장하는 배열
  • inputLeftHands : 캠으로 입력된 손동작에서 왼손의 1~21번 포인트까지의 x,y,z 좌표값
  • inputRightHands : 캠으로 입력된 손동작에서 오른손의 1~21번 포인트까지의 x,y,z 좌표값
• output
  • status: 해당 손동작의 존재 여부
    • false: 없는 동작
    • true: 있는 동작
  • handName : status가 true인 경우 찾아낸 동작의 이름
• desc
  • hand-detect 노드로 부터 나온 payload

hand-register

• input
  • multiHandLandmarks : media pipe hands 모델의 아웃풋. 각 손의 1~21번 포인트까지의 x,y,z 좌표값
  • mutiHandedness : media pipe hands 모델의 아웃풋. 각 손의 정보
  • savedLeftHand : db에 저장되어 있는 왼손 좌표의 json 배열들을 저장한 배열
  • savedRightHand : db에 저장되어 있는 오른손 좌표의 json 배열들을 저장한 배열
  • savedNameList : db에 저장되어 있는 손동작의 이름을 저장하는 배열
  • poseName : 새로 등록하려는 손동작의 명칭
• output
  • status : 등록 가능 여부
    • true: 등록가능. 기존에 없는 손동작
    • false: 등록불가
  • handName : db에 등록되는 손동작 명칭
  • inputLeftHand : db에 등록되는 손동작에서 왼손의 1~21번 포인트까지의 x,y,z 좌표값
  • inputRightHand : db에 등록되는 손동작에서 오른손의 1~21번 포인트까지의 x,y,z 좌표값

Reference

• Node-RED Creating Nodes
• Google Mediapipe Repository
• Tensorflow Model Github Repository