Skip to content

AlexandreGastonBellegarde/LoopAR-public-

Repository files navigation

Westdrive LoopAR Private Repository

Westdrive LoopAR Logo

Westdrive Version Main Branch

Introduction

Important Notice:

For better ease of use we have devided the project into two seperate repositories, one containing 3d assets and model called Westdrive Assets Foundation and the other for functionalities of Westdrive which is called Westdrive Core. One can use these two repositories combined or separetely to create their own simulation outside the scope of senarios existing in this version of Westdrive.

you can find the Westdrive Assets Foundation here : https://gitlab.com/farbod69/westdrive-asset-foundation

Hardware Requirements

Minimum Requirements

  • Intel Core i7 7th Generation
  • 16 Gb RAM
  • Geforce GTX 1070Ti
  • Operating System: Windows 10 home

Sugessted Requirements

  • Intel Core i7/i9 8th Generation or newer
  • 16 Gb RAM
  • Geforce GTX 1080Ti or better
  • Operating System: Windows 10 home

Project Westdrive has been developed and tested on following Hardwares:

System 1: CPU RAM Graphics Card OS Performance Quality


System 2: CPU RAM Graphics Card OS Performance Quality

Software requirements for VR version

Unity Version dot net compatibiliyy SteamVR Plugin TobiiXR Plugin Sranipal Plugin Render Pipeline

Software requirements for non-VR version

Unity Version dot net compatibiliyy Render Pipeline

Testing Releases:

VR Version:

  • You will need to be in possessions of HTC Vive Pro Eye
  • You need SteamVR and Tobii XR installed on the system

if you have never used Tobii Eyetracker inside HTC Vive Pro Eye before you have to first accept their term of use and enable the eye tacker from StreamVR main environment before running Projoct LoopAR

None VR Version:

-You just need the executable of the project.

remarks on the project

  • the project has been tested on Nvidia 2080 Ti as well as Nvidia GTX 1070 yielding a performance stable around 60 FPS

Note: The executable release is meant to be a showcase of the current LoopAR Alpha capabilities. Westdrive is meant to be customized and built for your specific needs. So we recommend you to download the code and build it yourself after implementing your own scenarios.

Note: We still consider LoopAR in alpha phase, This is currently under the status of MVP (Minimum Viable Product) meaning it only implements the main functionalities of LoopAR. There will be many features that will be added during the mounths to come. We will always push the stable changes to the public LoopAR repository

Builded version

-you can download the standalone VR version here

-you can download the standalone non VR version here

Build prepration

in the following section, it is explained how you can clone and improt the project for build and developement inside Unity environment.

Step one: Preparing Unity

please download the corresponding version Unity and install it on your machine. It is highly recommended to download and install Unity through Unity Hub. It is easier to manage various installations of Unity when using Unity Hub. You can find more information on Unity Hub here.

-Download and install relavant requirment depending on VR or Non VR version of the project

notice:

Please always make sure you are using the unity version mentioned here to ensure correct build and functionality of Westdrive.

Step two: cloning the project

First make sure you have installed a git client on you machine. If you need one you can find many of them online. Alternatively you can just download and install official Github client for Microsot Windows.

if you just want to use Project westdrive you can alternatively dowload the project as an archive file (see below), however to contribute to the project or make your own forks you will need a Github account.

Third party assets

in the following secion all used assets with their links in the unity asset sote, with their corresponding functionality is listed.

Important note:

After our communication with creators of some paied third party assets, they have gave us permission to share those assets for Academic purposes only in limited numbers. If you want to have access to those assets please write us an email with the name of your institution and project overview so we can add you to LoopAR private repository. The following 3rd party assets has been removed from our public repository.

  • EasyRoads Version 3.0

note:

Assets are separeted in taged with paid and free, and also essential or optional.

note:

If you plan to use the paid assets in other projects, please make sure you purchase them for your organization in the Unity asset store

note:

optional assets are usualy 3d assets that can be replaced by your own designs or other 3d models.

List of assets

Asset Name Link on Asset Store Description Paid / Free Essentail / Optional
+ SteamVR 1.1.2.0 SteamVR Plugin main api to use HTV Vive/ Vive Pro HMDs in Unity3D free note:
+ TobiiXR 1.8.0 TobiiXR SDK Main api to use HTV Vive Pro Eye eye tacker in Unity3D free note:
+ SRanipal SRanipal SDK Main SDK for HTC vive pro eye in conjunction to TobiiXR in order to use eyetracking in UnityED free note:
* SS07 Unlock super sport car #07 one of the car assets used in the project paid note:
* EasyRoads3D v3 pro EasyRoads3D v3 pro Create unique road networks directly in Unity with both built-in customizable dynamic crossing prefabs and custom crossing prefabs based on your own imported models paid note:
Conifers [BOTD] Conifers his package contains 4 conifers derived from Unity's Book of the Dead Demo – reworked, optimized and imported using the Custom Tree Importer to make them compatible with the "legacy" rendering pipeline. free note:
Standard Assets Standard Assets This collection of assets, scripts, and example scenes can be used to kickstart your Unity learning or be used as the basis for your own projects. free note:
Grass Flowers Pack Free Grass Flowers Pack Free This pack contains 12 grass and flower textures(Resolution 1024x1024,Alpha Channel). free note:
Rocky Hills Environment - light pack Rocky Hills Environment - light pack High quality, low poly model pack, good for any kind of platform, mobile friendly and very aesthetic for higher quality game development. Includes models from a early project. Each model from the Legacy project comes with 2 Lod levels. free note:
Terrain Tools Sample Asset Pack Terrain Tools Sample Asset Pack The Terrain Tools Sample Asset Pack contains a collection of Assets to jump-start development for users interested in utilizing Unity’s growing Terrain system. free note:
Farm Machinery Farm Machinery This is a low poly style model pack of a farm tractor and a planter. free note:
Wooden Box Wooden Box This package contains a wooden box in four states: One intact and three destroyed versions. free note:
Industrial Set - Scaffolding Industrial Set - Scaffolding game ready scaffold set, no LODs, PBR Textures. free note:
Wood panels Wood panels 3 wood panels Assets for Cities: Skylines. free note:
Starbucks Coffee Starbucks Coffee Starbucks Coffee Asset for Cities: Skylines. free note:
Boulangerie de l’Opéra Boulangerie de l’Opéra A typical french bakery Asset for Cities: Skylines. free note:
Pile of Planks Pile of Planks Just an optimised low poly pile of planks with PBR textures. free note:
Pile of Planks Pile of Planks Just an optimised low poly pile of planks with PBR textures. free note:
Picnic Tables Picnic Tables Set of worn down Picnic tables. free note:
France - Cities: Skyline models France - Cities: Skyline models French custom assets Lost Gecko created for the city-builder video game Cities: Skylines. free note:
Hyundai Excavator Hyundai Excavator An Excavator. Pictures taken with D5300 + 10mm Sigma + Parrot Anafi. Added LODs free note:
a pile of clay a pile of clay A good reference or gameobject to a computer game. Photogrammetry from 99 photos. free note:
a pile of sand a pile of sand A good reference or gameobject to a computer game. Photogrammetry from 107 photos. free note:
Microsoft Lumia 950 Microsoft Lumia 950 Simple low poly model of the Microsoft Lumia 950, Windows 10 flagship. free note:
Windmill Windmill A low-poly Windmill. Textures are hand painted and the model is fully UV textured. free note:
Observatory Observatory An astronomical Observatory. free note:
Animated Stag Deer 3D Model Animated Stag Deer 3D Model Highly detailed and rigged 3d model of a stag, with walk and attack animations. free note:
HUD warning sign HUD warning sign Simple red triangle. free note:
** HUD sound Event HUD sound Event Warning Sound. free note:
** HUD sound EventEnd HUD sound EventEnd Normal beep. free note:

*

This asset is removed for LoopAR public repository but still accessable through LoopAR private repository.

**

These sounds has been used for testing the functionalities and will change in the next update.

+

Essential to work on both VR and non VR version of the project, please note that you can only download the latest version from the given links, however versions relavant to the project LoopAR are included in the repository

Honorary Mentions

We want to mention Penny de byl for her outstanding videos in Udemy which helped us alot in simulating physical cars in Unity3d

Avatars and animations:

Avaratars and animations in westdrive is created by us using Adobe Mixamo and Fuse cc. At the momenet westdrive is using avatars of our own creation using mentioned tools but due to their complex mesh anatomy we are replacing them with simpler low poly avatars created by us in blender soon.

acknowledgement to creators and team assistants

Our acknowledgement goes to creator of all free and paid assets mentioned above, Adobe, Unity Technologies and Blenders for their tools as well as following persons who helped us in creating and maintaining Westdrive

  • Phillip Spaniol - main graphic designer for our team, also worked on the city environment
  • Johannes Maximilian Pingle - HUD functionalities and basics of the city environment
  • Lea Maria Kühne - worked on the sanity and realism of traffical event, also responsible for country road and main experiment scene for currect LoopAR version
  • Linus Tiemann - Main car drive functionalities, eye-tracker and input connection
  • Nora Maleki - AI functionalities of the cars and pedestrians
  • Lynn Keller - Mountain road environment, responsible for graphical sanity and quality of environments
  • Anke Haas - Autobahn environment
  • Frederik Nienhaus - Test scene environment
  • Farbod Nosrat Nezami - technical supervisor of the project
  • Maximilian Alexander Wächter - Behavioral supervisor of the project
  • Prof. Dr. Peter König - main supervisor of the project
  • Prof. Dr. Gordon Pipa - second supervisor of the project
  • Stahlwerk Stiftung Georgsmarienhütte, University of Osnabrück and Deutsche Forschungsgemeinschaft for their financial support

All members of the team work equaly on background research and refinment of the study

current term of use

You are free to share, change and use Westdrive in whatever maner you like as long as you accept the following conditions:

-Westdrive LoopAR is an open source driving simulation for self driving cars, special navigation, embodid cognition and similiar experiments. It is made available for scientists and anyone who is interested in research in an Virtual environement. Therefore any financial use of this tool is prohibited.

-Assets presented here are mainly free assets from unity asset store which can be used in other projects, however if you plan to use assets that are paid please purchase them for your organization from the unity asset store. Developing team of Westdrive does not accept any responsibility regarding this matter and we are strictly against piracy.

announcement:

Currently Testdrive scene is not included in the build however it exist fully in the repo, we are posishing, and testing it in the following days and as soon as it passes the main quality checks we will include them in the build versions

License

All Documentation content that resides under the doc/ directory of this repository is licensed under Creative Commons: License: CC BY-NC-SA 4.0

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages