The Perception package contains tools for authoring and executing autonomous vehicle simulations. They are organized into two categories: Scenarios and Sensors.

TODO

• Clone the perception repository into an arbirary directory on disk
• Install and use Unity 2019.3.0b7

The repository includes two projects for local development in TestProjects, one set up for HDRP and the other for URP.

The following instructions reference the Unity doc's page on installing a local package

• Create a new HDRP project or open an existing one
• Open your project's <project root>/Packages/manifest.json in a text editor
• At the end of the file, add "registry": "https://artifactory.prd.cds.internal.unity3d.com/artifactory/api/npm/upm-candidates"
  • Note: This step will be removed once the dependency com.unity.entities-0.2.0-preview.* is published publically.
• Back in Unity, open the Package Manager window
• Add the High Definition RP package, version 7.1.2 or later
• Click the + button in the upper lefthand corner of the window
• Click the add package from disk option
• Select to the package.json file under the com.unity.perception folder in your cloned perception repository
• To allow the compilation and running of tests, add "testables": [ "com.unity.perception" ]
  • For an example manifest.json, see TestProjects/PerceptionTest/Packages/manifest.json
  • For more on the manifest.json schema, see the Package Manager documentation

For closest standards conformity and best experience overall, JetBrains Rider or Visual Studio w/ JetBrains Resharper are suggested. For optimal experience, perform the following additional steps:

• To allow navigating to code in all packages included in your project, in your Unity Editor, navigate to Edit -> Preferences... -> External Tools and check Generate all .csproj files.
• To get automatic feedback and fixups on formatting and naming convention violations, set up Rider/JetBrains with our Unity standard .dotsettings file by following these instructions.
• If you use VS Code, install the Editorconfig extension to get automatic code formatting according to our conventions.