From 652d941f25346155fb802fa18176c8a0c4bebf1b Mon Sep 17 00:00:00 2001 From: Marek Date: Thu, 15 Oct 2015 17:19:40 +0200 Subject: [PATCH 1/3] Create README.md --- README.md | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..e862c7d --- /dev/null +++ b/README.md @@ -0,0 +1,4 @@ +# LiveScan3D +LiveScan3D is a system designed for real time 3D reconstruction using multiple Kinect v2 depth sensors simultaneously at real time speed. + +README comming soon. From 197bad41fec6ade840bd1ca28744960caa2bea5a Mon Sep 17 00:00:00 2001 From: Marek Date: Fri, 16 Oct 2015 11:12:11 +0200 Subject: [PATCH 2/3] Update README.md --- README.md | 32 ++++++++++++++++++++++++++++++-- 1 file changed, 30 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index e862c7d..81e6cd0 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,32 @@ -# LiveScan3D +# LiveScan3D # LiveScan3D is a system designed for real time 3D reconstruction using multiple Kinect v2 depth sensors simultaneously at real time speed. -README comming soon. +The produced 3D reconstruction is in the form of a coloured point cloud, with points from all of the Kinects placed in the same coordinate system. Possible use scenarios of the system include: + * capturing an object’s 3D structure from multiple viewpoints simultaneously, + * capturing a “panoramic” 3D structure of a scene (extending the field of view of one sensor by using many), + * increasing the density of a point cloud captured by a single sensor, by having multiple sensors capture the same scene. + +At the moment connecting multiple Kinect v2 devices to a single computer is difficult and only possible under Linux. Also, the number of the devices or capture speed might be low, because of the limitations of the PCI-E bus. + +Because of those limitations, in our system each Kinect v2 sensor is connected to a separate computer. Each of those computers is connected to a server which governs all of the sensors. The server allows the user to perform calibration, filtering, synchronized frame capture, and to visualize the acquired point cloud live. + +## How to use it ## +To start working with our software you will need a Windows machine with the Kinect for Windows SDK 2.0, and at least a single Kinect v2 device. You can either build LiveScan3D from source which is easiest using Visual Studio, or you can download the binaries from: http://ztv.ire.pw.edu.pl/mkowalski/. + +Both the binary and source distributions contain a manual (in the docs directory) which contains the steps necessary to start working with our software (it won't take more than a couple of minutes to set up). + +## Where to get help ## +If you have any problems feel free to contact us: Marek Kowalski , Jacek Naruniec . We usually answer emails quickly (our timezone is CET). + +For details regarding the methods used in LiveScan3D you can take a look at our article: "LiveScan3D: A Fast and Inexpensive 3D Data Acquisition System for Multiple Kinect v2 Sensors" once it is released. + +## Licensing ## +While all of our code is licensed under the MIT license, the 3rd party libraries have different licenses: + * nanoflann - https://github.com/jlblancoc/nanoflann, BSD license + * OpenCV - https://github.com/Itseez/opencv, 3-clause BSD license + * OpenTK - https://github.com/opentk/opentk, MIT/X11 license + * SocketCS - http://www.adp-gmbh.ch/win/misc/sockets.html + +## Authors ## + * Marek Kowalski , homepage: http://ztv.ire.pw.edu.pl/mkowalski/ + * Jacek Naruniec , homepage: http://home.elka.pw.edu.pl/~jnarunie/ From 3e846180a7677415a6fad283b01fd36f89f048df Mon Sep 17 00:00:00 2001 From: Marek Date: Fri, 16 Oct 2015 14:00:11 +0200 Subject: [PATCH 3/3] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 81e6cd0..2a82832 100644 --- a/README.md +++ b/README.md @@ -11,7 +11,7 @@ At the moment connecting multiple Kinect v2 devices to a single computer is diff Because of those limitations, in our system each Kinect v2 sensor is connected to a separate computer. Each of those computers is connected to a server which governs all of the sensors. The server allows the user to perform calibration, filtering, synchronized frame capture, and to visualize the acquired point cloud live. ## How to use it ## -To start working with our software you will need a Windows machine with the Kinect for Windows SDK 2.0, and at least a single Kinect v2 device. You can either build LiveScan3D from source which is easiest using Visual Studio, or you can download the binaries from: http://ztv.ire.pw.edu.pl/mkowalski/. +To start working with our software you will need a Windows machine with the Kinect for Windows SDK 2.0, and at least a single Kinect v2 device. You can either build LiveScan3D from source which is easiest using Visual Studio, or you can download the binaries from: http://home.elka.pw.edu.pl/~mkowals6/. Both the binary and source distributions contain a manual (in the docs directory) which contains the steps necessary to start working with our software (it won't take more than a couple of minutes to set up). @@ -28,5 +28,5 @@ While all of our code is licensed under the MIT license, the 3rd party libraries * SocketCS - http://www.adp-gmbh.ch/win/misc/sockets.html ## Authors ## - * Marek Kowalski , homepage: http://ztv.ire.pw.edu.pl/mkowalski/ + * Marek Kowalski , homepage: http://home.elka.pw.edu.pl/~mkowals6/ * Jacek Naruniec , homepage: http://home.elka.pw.edu.pl/~jnarunie/