Giter VIP home page Giter VIP logo

mora-adl's Introduction

Mora-ADL

A multi-modal Human Activities of Daily Living dataset and Data Collection Tool.

Mora ADL Mora ADL-Tool License: CC0 Python 3.7

Table of contents

Dataset

Link

Mora-ADL Dataset

Dataset properties

7 data streams:

  • Depth image stream
  • RGB image stream
  • Skeleton data stream
  • Silhouette stream
  • 3 audio streams

24 Activities of Daily Living:

  • Making a phone call, Clapping, Drinking, Eating, Entering from door, Exiting from door, Falling, Lying down, Opening pill container, Picking object, Reading, Sit still, Sitting down, Sleeping, Standing up, Sweeping, Using laptop, Using phone, Wake up, Walking, Washing hand, Watching TV, Water pouring and Writing

17 subjects:

  • 11 males
  • 6 females

Continuous dataset to test continuous activity classification.

  • Performed by 3 subjects
  • In 2 different environments

Playing depth video

Run playDepthVideo.py with the following arguments to play a depth video file.

  • -d depth file path
  • -s skeleton file path
  • -sil (Optional) True/False [True to view silhouette view. False to view depth image view]

Skeleton data stream

The skeleton data stream has 5 values per row and for each frame it has 15 such rows. The 15 rows gives the positions of the 15 joint positions as in the below figure.

Skeleton joint position

The 5 values of the row stands for:

  • X coordinate using the "real world" coordinate system
  • Y coordinate using the "real world" coordinate system
  • Z coordinate using the "real world" coordinate system
  • X coordinates of the depth map
  • Y coordinates of the depth map

Data Collection Tool

Data collection tool written using python to collect depth, RGB, audio, silhouette and skeleton data using the Microsoft Kinect device and the OpenNI/NiTE tool.

Using the tool

Setting up dependencies

Please follow the following steps if you have not installed Kinect SDK, OpenNI or NiTE tool.

Step 1

  1. Download & install Kinect SDK 1.8 or higher version from here or another source.
  2. Download & install OpenNI 2.2 or higher version from here or another source.
  3. To verify the setup run SimpleViewer in Program files -> OpenNI2 -> Samples -> Bin
  4. Download & install Nite 2.2 or higher version from here or another source.
  5. To verify the setup run UserViewer in Program files -> PrimeSense -> NiTE2 ->Samples -> Bin

Step 2

  1. Download openni-python repository from here.
  2. Extract it to a preferred location.
  3. Copy NiTE2 and OpenNI2 folders in Program files -> PrimeSense -> NiTE2 -> Samples to the openni-python.

Step 3

  1. Copy the dataset tool (dataCollectionTool.py) and audioDevices.py to the openni-python folder.

Running the tool

First, run the audioDevices.py to detect the port numbers of the microphones.

Then run dataCollectionTool.py in the command line using the following command.

$ python audioDevices.py -d <<microphone_ports>> -p <<location_to_save_data>> -s <<subject_name>> -a <<act_name>> 

To stop recording press Ctrl + c in the command line.

License

Creative Commons Zero v1.0 Universal

Citation

If you use the Mora-ADL dataset or the Mora-ADL Data Collection Tool please cite:

Madhuranga, D., Madushan, R., Siriwardane, C. et al. Real-time multimodal ADL recognition using convolution neural networks. Vis Comput (2020). https://doi.org/10.1007/s00371-020-01864-y

C. Siriwardhana, D. Madhuranga, R. Madushan and K. Gunasekera, "Classification of Activities of Daily Living Based on Depth Sequences and Audio," 2019 14th Conference on Industrial and Information Systems (ICIIS), Kandy, Sri Lanka, 2019, pp. 278-283, doi: 10.1109/ICIIS47346.2019.9063306.

Collaborators

Rivindu Madushan

Danushkka Madhuranga

Chathuranga Siriwardhana

mora-adl's People

Contributors

rivindum avatar dmadhuranga avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.