Skip to content

yanhuizen/T_System

 
 

Repository files navigation

T_System

the (non-)moving objects tracking system via two axis camera motion and n joint robotic arm for raspberry pi distributions

Github contributors Github release Github stars

Badge Emoji License: MIT

Travis Read The Docs Coveralls Pyup shield Pyup python-3 shield Contributor Covenant

T_System


Supported Environments

Operating systems Linux
Python versions Python 3.x (64-bit)
Distros Raspbian
Package managers APT, pip
Languages English

Requirements

Hardware
  • Raspberry Pi 2,3 B, B + or higher
  • Raspberry Pi Camera
  • n servo motors
  • 2 axis as pan-tilt motions for t_system's locking target ability
  • n-2 axis for t_system's robotic arm feature (Optional)
Software
  • All requirement libraries automatically installing via installation scripts. To see these libraries look at here

Installation

Clone the GitHub repository and run

sudo ./install.sh

in the repository directory.

for development mode: sudo ./install-dev.sh

If there is a failure try sudo -H ./install-dev.sh

Usage

usage: t_system [-h] [--interface {official_stand,augmented,remote_ui,None}]
                [--stand-gpios RED-LED GREEN-LED FAN] [--host HOST]
                [--port PORT] [--debug] [-l] [-s]
                [--detection-model DETECTION_MODEL]
                [--cascade-file CASCADE_FILE] [-j]
                [--encoding-file ENCODING_FILE] [--use-tracking-api]
                [--tracker-type {BOOSTING,MIL,KCF,TLD,MEDIANFLOW,GOTURN,MOSSE,CSRT}]
                [--resolution WIDTH HEIGHT] [--framerate FRAMERATE]
                [--chunk CHUNK] [--rate RATE] [--channels CHANNELS]
                [--audio_device_index AUDIO_DEVICE_INDEX]
                [--record-formats VIDEO AUDIO MERGED] [--robotic-arm ARM]
                [--ls-gpios PAN TILT]
                [--AI AI | --non-moving-target | --arm-expansion] [-p]
                [--ap-wlan AP_WLAN] [--ap-inet AP_INET] [--ap-ip AP_IP]
                [--ap-netmask AP_NETMASK] [--ssid SSID] [--password PASSWORD]
                [--wlan WLAN] [--inet INET] [--static-ip STATIC_IP]
                [--netmask NETMASK] [--country-code COUNTRY_CODE]
                [--environment {production,development,testing}]
                [--no-emotion] [-S]
                [-m {single_rect,rotating_arcs,partial_rect,animation_1,None}]
                [-r] [-v] [--version]
                {id,remote-ui-authentication,face-encoding,self-update} ...

positional arguments:
  {id,remote-ui-authentication,face-encoding,self-update}
                        officiate the sub-jobs
    id                  Make identification jobs of T_System.
    remote-ui-authentication
                        Remote UI administrator authority settings of the
                        secret entry point that is the new network connection
                        panel.
    face-encoding       Generate encoded data from the dataset folder to
                        recognize the man T_System is monitoring during
                        operation.
    self-update         Update source code of t_system itself via `git pull`
                        command from the remote git repo.

optional arguments:
  -h, --help            show this help message and exit

For detailed output look at Help

t_system user-interfaces {official_stand,augmented,remote_ui,None} is standard running command.

official_stand, augmented and remote_ui are mentioned here, here and here as respectively.

Detailed usage available inside USAGE.md

Interfaces

Official Stand

Portable usage interface v0.5


  • Dependencies

    • Raspberry pi 4 model B/B+.
    • 2 pieces mg995, 3 pieces sg90 or mg90s servo motors.
  • Properties

    1.25 times bigger than the previous version.

    • Tiny Camera

        8x8mm dimensions 8MP resolution micro camera.
      
    • IR led

        Automatically activatable IR led for advanced night vision. 
      
    • 1 switch key for on/off

        Cut the electiric current directly.
      
    • 4 pieces 18650 li-ion batteries

        Parallel connected sources.
      
    • Internal Cooler

        2 pieces 30x30x10mm micro fan and the aluminyum block for falling down the cpu temperature.
      
    • Local Network Management

        Scan the around networks. If there is no network connection become an Access Point and serve Remote UI ınternally.
      
    • Remote UI accessing

        No control by tapping. Accessing with Remote UI from mobile or desktop.
      

To see the old version explaining go here

Remote UI

The remotely controlling interface v0.9.65

  • Properties

    • Motion Control

        2 kind control type for the arm. 
            
            1: axis based control. move all axes separately.
            2: direction based control. move according the direction (up-down/forward-backward/right-left).
      
    • Scenario Control

        create scenarios by specifying arm positions and generating motion paths with them for behaving like a camera dolly.
      
    • Previewing / Monitoring

        watch the live video stream during creating scenarios and monitor what is it recording on working.
      
    • Network Control

        Add, update or delete Wi-Fi connection info.
      
    • Recognize People

        Add, update and delete the photos of the people for recognizing them. Choose one, more or all and recognize during the job.
      
    • Record Control

        Get preview or download the video records with the date based sorting system.
      

Powered by "flask" as an embedded framework. Available on mobile and desktop.

Augmented

Augmented usage explained here into the AUGMENTED.md.


Supported Distributions: Raspbian. This release is fully supported. Any other Debian based ARM architecture distributions are partially supported.

Contribute

If you want to contribute to T_System then please read this guide.

Please consider to support us with buying a coffee: Buy Me A Coffee

About

the moving objects tracking system via two axis camera motion (and as optionally n joint robotic arm) for raspberry pi distributions

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 72.1%
  • JavaScript 18.8%
  • CSS 4.5%
  • HTML 3.7%
  • Other 0.9%