Changed the namespace of randomization tools to UnityEngine.Experimental (#74)

* changed the namespace of randomization tools to experimental

* moved randomization UI code to experimental namespace

* updated docs to emphasize that the randomization tools are experimental

* updated changelog

com.unity.perception/CHANGELOG.md

 ## [0.4.0-preview.1] - 2020-08-07
 
 ### Added
-Added new randomization tools
+
+Added new experimental randomization tools
 
 Added support for 2020.1
 

com.unity.perception/Documentation~/Randomization/Index.md

 # Overview
 
+*NOTICE: The perception randomization toolset is currently marked as experimental and will experience a number of updates in the near future.*
+
 The randomization toolset simplifies randomizing aspects of generating synthetic data. It facilitates exposing parameters for randomization, offers samplers to pick random values from parameters, and provides scenarios to define a full randomization process. Each of these also allows for custom implementations to fit particular randomization needs.
 
 **What is Domain Randomization?**

com.unity.perception/Documentation~/index.md

 
 [Setting up your first perception scene](GettingStarted.md)
 
-[Randomizing your simulation](Randomization/Index.md)
+[Randomizing your simulation (Experimental)](Randomization/Index.md)
 
 ## Example projects using Perception
 
 |[LabelConfig](GroundTruth-Labeling.md#LabelConfig)|Asset which defines a taxonomy of labels for ground truth generation|
 |[Perception Camera](PerceptionCamera.md)|Captures RGB images and ground truth from a [Camera](https://docs.unity3d.com/Manual/class-Camera.html)|
 |[DatasetCapture](DatasetCapture.md)|Ensures sensors are triggered at proper rates and accepts data for the JSON dataset|
-|[Randomization](Randomization/Index.md)|Integrate domain randomization principles into your simulation|
+|[Randomization (Experimental)](Randomization/Index.md)|Integrate domain randomization principles into your simulation|
-* The Linux Editor 2019.4.7f1 and 2019.4.8f1 have been found to hang when importing HDRP-based perception projects. For Linux Editor support, use 2019.4.6f1 or 2020.1
+* The Linux Editor 2019.4.7f1 and 2019.4.8f1 have been found to hang when importing HDRP-based perception projects. For Linux Editor support, use 2019.4.6f1 or 2020.1

com.unity.perception/Editor/Randomization/CategoricalOptionElement.cs

 using UnityEditor.UIElements;
 using UnityEngine.UIElements;
 
-namespace UnityEngine.Perception.Randomization.Editor
+namespace UnityEngine.Experimental.Perception.Randomization.Editor
 {
     class CategoricalOptionElement : VisualElement
     {

com.unity.perception/Editor/Randomization/FloatRangeElement.cs

 using UnityEditor.UIElements;
 using UnityEngine.UIElements;
 
-namespace UnityEngine.Perception.Randomization.Editor
+namespace UnityEngine.Experimental.Perception.Randomization.Editor
 {
     class FloatRangeElement : VisualElement
     {

com.unity.perception/Editor/Randomization/ParameterConfigurationEditor.cs

 using UnityEngine;
 using UnityEditor;
 using UnityEditor.UIElements;
-using UnityEngine.Perception.Randomization.Configuration;
-using UnityEngine.Perception.Randomization.Parameters;
+using UnityEngine.Experimental.Perception.Randomization.Configuration;
+using UnityEngine.Experimental.Perception.Randomization.Parameters;
-namespace UnityEngine.Perception.Randomization.Editor
+namespace UnityEngine.Experimental.Perception.Randomization.Editor
 {
     [CustomEditor(typeof(ParameterConfiguration))]
     class ParameterConfigurationEditor : UnityEditor.Editor

com.unity.perception/Editor/Randomization/ParameterDragBar.cs

 using UnityEngine.UIElements;
 
-namespace UnityEngine.Perception.Randomization.Editor
+namespace UnityEngine.Experimental.Perception.Randomization.Editor
 {
     class ParameterDragBar : VisualElement
     {

com.unity.perception/Editor/Randomization/ParameterDragManipulator.cs

 using UnityEngine.UIElements;
 
-namespace UnityEngine.Perception.Randomization.Editor
+namespace UnityEngine.Experimental.Perception.Randomization.Editor
 {
     class ParameterDragManipulator : MouseManipulator
     {

com.unity.perception/Editor/Randomization/ParameterElement.cs

 using System.Collections.Generic;
 using UnityEditor;
 using UnityEditor.UIElements;
-using UnityEngine.Perception.Randomization.Parameters;
+using UnityEngine.Experimental.Perception.Randomization.Parameters;
-namespace UnityEngine.Perception.Randomization.Editor
+namespace UnityEngine.Experimental.Perception.Randomization.Editor
 {
     class ParameterElement : VisualElement
     {

com.unity.perception/Editor/Randomization/RandomSeedField.cs

 using UnityEditor.UIElements;
 using UnityEngine.UIElements;
 
-namespace UnityEngine.Perception.Randomization.Editor
+namespace UnityEngine.Experimental.Perception.Randomization.Editor
 {
     class RandomSeedField : IntegerField
     {

com.unity.perception/Editor/Randomization/SamplerElement.cs

 using System;
 using UnityEditor;
 using UnityEditor.UIElements;
-using UnityEngine.Perception.Randomization.Parameters;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Parameters;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
-namespace UnityEngine.Perception.Randomization.Editor
+namespace UnityEngine.Experimental.Perception.Randomization.Editor
 {
     class SamplerElement : VisualElement
     {

com.unity.perception/Editor/Randomization/ScenarioBaseEditor.cs

 using UnityEditor;
 using UnityEditor.UIElements;
-using UnityEngine.Perception.Randomization.Scenarios;
+using UnityEngine.Experimental.Perception.Randomization.Scenarios;
-namespace UnityEngine.Perception.Randomization.Editor
+namespace UnityEngine.Experimental.Perception.Randomization.Editor
 {
     [CustomEditor(typeof(ScenarioBase), true)]
     class ScenarioBaseEditor : UnityEditor.Editor

com.unity.perception/Editor/Randomization/StaticData.cs

 using System;
 using System.Collections.Generic;
 using UnityEditor;
-using UnityEngine.Perception.Randomization.Parameters;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Parameters;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
-namespace UnityEngine.Perception.Randomization.Editor
+namespace UnityEngine.Experimental.Perception.Randomization.Editor
 {
     static class StaticData
     {

com.unity.perception/Runtime/GroundTruth/PerceptionCamera.cs

 using System;
 using System.Collections.Generic;
-using System.IO;
-using Unity.Collections;
-using Unity.Collections.LowLevel.Unsafe;
-using UnityEngine.Perception.Randomization.Scenarios;
-using UnityEngine.Serialization;
-using UnityEngine.UI;
 #if HDRP_PRESENT
 using UnityEngine.Rendering.HighDefinition;
 #endif

com.unity.perception/Runtime/Randomization/Configuration/ParameterConfiguration.cs

 using System;
 using System.Collections.Generic;
 using UnityEngine;
-using UnityEngine.Perception.Randomization.Parameters;
+using UnityEngine.Experimental.Perception.Randomization.Parameters;
-namespace UnityEngine.Perception.Randomization.Configuration
+namespace UnityEngine.Experimental.Perception.Randomization.Configuration
 {
     /// <summary>
     /// Creates parameter interfaces for randomizing simulations

com.unity.perception/Runtime/Randomization/Configuration/ParameterConfigurationException.cs

 using System;
 
-namespace UnityEngine.Perception.Randomization.Configuration
+namespace UnityEngine.Experimental.Perception.Randomization.Configuration
 {
     [Serializable]
     class ParameterConfigurationException : Exception

com.unity.perception/Runtime/Randomization/Parameters/CategoricalParameter.cs

 using System;
 using System.Collections.Generic;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
-namespace UnityEngine.Perception.Randomization.Parameters
+namespace UnityEngine.Experimental.Perception.Randomization.Parameters
 {
     /// <summary>
     /// Generates samples by choosing one option from a list of choices

com.unity.perception/Runtime/Randomization/Parameters/CategoricalParameterBase.cs

 using System;
 using System.Collections.Generic;
 
-namespace UnityEngine.Perception.Randomization.Parameters
+namespace UnityEngine.Experimental.Perception.Randomization.Parameters
 {
     /// <summary>
     /// The base class of CategoricalParameters.

com.unity.perception/Runtime/Randomization/Parameters/NumericParameter.cs

 using System;
 using Unity.Collections;
 using Unity.Jobs;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
-namespace UnityEngine.Perception.Randomization.Parameters
+namespace UnityEngine.Experimental.Perception.Randomization.Parameters
 {
     /// <summary>
     /// Numeric parameters use samplers to generate randomized structs

com.unity.perception/Runtime/Randomization/Parameters/Parameter.cs

 using System;
 using UnityEngine;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
-namespace UnityEngine.Perception.Randomization.Parameters
+namespace UnityEngine.Experimental.Perception.Randomization.Parameters
 {
     /// <summary>
     /// Parameters, in conjunction with a parameter configuration, are used to create convenient interfaces for

com.unity.perception/Runtime/Randomization/Parameters/ParameterTarget.cs

 using System;
 
-namespace UnityEngine.Perception.Randomization.Parameters
+namespace UnityEngine.Experimental.Perception.Randomization.Parameters
 {
     /// <summary>
     /// Used to apply sampled parameter values to a particular GameObject, Component, and property.

com.unity.perception/Runtime/Randomization/Parameters/ParameterTypes/BooleanParameter.cs

 using Unity.Burst;
 using Unity.Collections;
 using Unity.Jobs;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
-namespace UnityEngine.Perception.Randomization.Parameters
+namespace UnityEngine.Experimental.Perception.Randomization.Parameters
 {
     /// <summary>
     /// A numeric parameter for generating boolean samples

com.unity.perception/Runtime/Randomization/Parameters/ParameterTypes/ColorHsvaParameter.cs

 using Unity.Burst;
 using Unity.Collections;
 using Unity.Jobs;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
-namespace UnityEngine.Perception.Randomization.Parameters
+namespace UnityEngine.Experimental.Perception.Randomization.Parameters
 {
     /// <summary>
     /// A numeric parameter for generating Color samples

com.unity.perception/Runtime/Randomization/Parameters/ParameterTypes/FloatParameter.cs

 using System;
 using Unity.Collections;
 using Unity.Jobs;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
-namespace UnityEngine.Perception.Randomization.Parameters
+namespace UnityEngine.Experimental.Perception.Randomization.Parameters
 {
     /// <summary>
     /// A numeric parameter for generating float samples

com.unity.perception/Runtime/Randomization/Parameters/ParameterTypes/GameObjectParameter.cs

 using System;
 
-namespace UnityEngine.Perception.Randomization.Parameters
+namespace UnityEngine.Experimental.Perception.Randomization.Parameters
 {
     /// <summary>
     /// A categorical parameter for generating GameObject samples

com.unity.perception/Runtime/Randomization/Parameters/ParameterTypes/IntegerParameter.cs

 using Unity.Burst;
 using Unity.Collections;
 using Unity.Jobs;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
-namespace UnityEngine.Perception.Randomization.Parameters
+namespace UnityEngine.Experimental.Perception.Randomization.Parameters
 {
     /// <summary>
     /// A numeric parameter for generating integer samples

com.unity.perception/Runtime/Randomization/Parameters/ParameterTypes/MaterialParameter.cs

 using System;
 
-namespace UnityEngine.Perception.Randomization.Parameters
+namespace UnityEngine.Experimental.Perception.Randomization.Parameters
 {
     /// <summary>
     /// A categorical parameter for generating Material samples

com.unity.perception/Runtime/Randomization/Parameters/ParameterTypes/StringParameter.cs

 using System;
 
-namespace UnityEngine.Perception.Randomization.Parameters
+namespace UnityEngine.Experimental.Perception.Randomization.Parameters
 {
     /// <summary>
     /// A categorical parameter for generating string samples

com.unity.perception/Runtime/Randomization/Parameters/ParameterTypes/Vector2Parameter.cs

 using Unity.Burst;
 using Unity.Collections;
 using Unity.Jobs;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
-namespace UnityEngine.Perception.Randomization.Parameters
+namespace UnityEngine.Experimental.Perception.Randomization.Parameters
 {
     /// <summary>
     /// A numeric parameter for generating Vector2 samples

com.unity.perception/Runtime/Randomization/Parameters/ParameterTypes/Vector3Parameter.cs

 using Unity.Burst;
 using Unity.Collections;
 using Unity.Jobs;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
-namespace UnityEngine.Perception.Randomization.Parameters
+namespace UnityEngine.Experimental.Perception.Randomization.Parameters
 {
     /// <summary>
     /// A numeric parameter for generating Vector3 samples

com.unity.perception/Runtime/Randomization/Parameters/ParameterTypes/Vector4Parameter.cs

 using Unity.Burst;
 using Unity.Collections;
 using Unity.Jobs;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
-namespace UnityEngine.Perception.Randomization.Parameters
+namespace UnityEngine.Experimental.Perception.Randomization.Parameters
 {
     /// <summary>
     /// A numeric parameter for generating Vector4 samples

com.unity.perception/Runtime/Randomization/Parameters/ParameterValidationException.cs

 using System;
 
-namespace UnityEngine.Perception.Randomization.Parameters
+namespace UnityEngine.Experimental.Perception.Randomization.Parameters
 {
     class ParameterValidationException : Exception
     {

com.unity.perception/Runtime/Randomization/Samplers/FloatRange.cs

 using System;
 using Unity.Assertions;
 
-namespace UnityEngine.Perception.Randomization.Samplers
+namespace UnityEngine.Experimental.Perception.Randomization.Samplers
 {
     /// <summary>
     /// A struct representing a continuous range of values

com.unity.perception/Runtime/Randomization/Samplers/ISampler.cs

 using Unity.Jobs;
 using UnityEngine;
 
-namespace UnityEngine.Perception.Randomization.Samplers
+namespace UnityEngine.Experimental.Perception.Randomization.Samplers
 {
     /// <summary>
     /// Generates random values from probability distributions

com.unity.perception/Runtime/Randomization/Samplers/SamplerTypes/ConstantSampler.cs

 using Unity.Collections;
 using Unity.Jobs;
 
-namespace UnityEngine.Perception.Randomization.Samplers
+namespace UnityEngine.Experimental.Perception.Randomization.Samplers
 {
     /// <summary>
     /// Returns a constant value when sampled

com.unity.perception/Runtime/Randomization/Samplers/SamplerTypes/NormalSampler.cs

 using Unity.Collections;
 using Unity.Jobs;
 
-namespace UnityEngine.Perception.Randomization.Samplers
+namespace UnityEngine.Experimental.Perception.Randomization.Samplers
 {
     /// <summary>
     /// Returns normally distributed random values bounded within a specified range

com.unity.perception/Runtime/Randomization/Samplers/SamplerTypes/UniformSampler.cs

 using Unity.Jobs;
 using Unity.Mathematics;
 
-namespace UnityEngine.Perception.Randomization.Samplers
+namespace UnityEngine.Experimental.Perception.Randomization.Samplers
 {
     /// <summary>
     /// Returns uniformly distributed random values within a designated range.

com.unity.perception/Runtime/Randomization/Samplers/SamplerUtility.cs

 using Unity.Jobs;
 using Unity.Mathematics;
 
-namespace UnityEngine.Perception.Randomization.Samplers
+namespace UnityEngine.Experimental.Perception.Randomization.Samplers
 {
     /// <summary>
     /// A set of utility functions for defining sampler interfaces

com.unity.perception/Runtime/Randomization/Scenarios/FixedLengthScenario.cs

 using System;
 
-namespace UnityEngine.Perception.Randomization.Scenarios
+namespace UnityEngine.Experimental.Perception.Randomization.Scenarios
 {
     /// <summary>
     /// A scenario that runs for a fixed number of frames during each iteration

com.unity.perception/Runtime/Randomization/Scenarios/Scenario.cs

 using System.IO;
 
-namespace UnityEngine.Perception.Randomization.Scenarios
+namespace UnityEngine.Experimental.Perception.Randomization.Scenarios
 {
     /// <summary>
     /// The base class of scenarios with serializable constants

com.unity.perception/Runtime/Randomization/Scenarios/ScenarioBase.cs

 using System;
 using UnityEngine;
 using UnityEngine.Perception.GroundTruth;
-using UnityEngine.Perception.Randomization.Configuration;
-using UnityEngine.Perception.Randomization.Parameters;
+using UnityEngine.Experimental.Perception.Randomization.Configuration;
+using UnityEngine.Experimental.Perception.Randomization.Parameters;
-namespace UnityEngine.Perception.Randomization.Scenarios
+namespace UnityEngine.Experimental.Perception.Randomization.Scenarios
 {
     /// <summary>
     /// The base class of all scenario classes

com.unity.perception/Runtime/Randomization/Scenarios/ScenarioException.cs

 using System;
 
-namespace UnityEngine.Perception.Randomization.Scenarios
+namespace UnityEngine.Experimental.Perception.Randomization.Scenarios
 {
     [Serializable]
     class ScenarioException : Exception

com.unity.perception/Tests/Runtime/Randomization/ParameterConfigurationTests.cs

 using System.Collections;
 using NUnit.Framework;
 using UnityEngine;
-using UnityEngine.Perception.Randomization.Configuration;
-using UnityEngine.Perception.Randomization.Parameters;
+using UnityEngine.Experimental.Perception.Randomization.Configuration;
+using UnityEngine.Experimental.Perception.Randomization.Parameters;
 using UnityEngine.TestTools;
 
 namespace RandomizationTests

com.unity.perception/Tests/Runtime/Randomization/ParameterTests/CategoricalParameterTests.cs

 using NUnit.Framework;
 using UnityEngine;
-using UnityEngine.Perception.Randomization.Parameters;
+using UnityEngine.Experimental.Perception.Randomization.Parameters;
 
 namespace RandomizationTests.ParameterTests
 {

com.unity.perception/Tests/Runtime/Randomization/ParameterTests/GenericParameterTests.cs

 using NUnit.Framework;
 using UnityEngine;
-using UnityEngine.Perception.Randomization.Parameters;
+using UnityEngine.Experimental.Perception.Randomization.Parameters;
 
 namespace RandomizationTests.ParameterTests
 {

com.unity.perception/Tests/Runtime/Randomization/ParameterTests/StructParameterTests.cs

 using System;
 using NUnit.Framework;
 using UnityEngine;
-using UnityEngine.Perception.Randomization.Parameters;
+using UnityEngine.Experimental.Perception.Randomization.Parameters;
 using Object = UnityEngine.Object;
 
 namespace RandomizationTests.ParameterTests

com.unity.perception/Tests/Runtime/Randomization/SamplerTests/ConstantSamplerTests.cs

 using NUnit.Framework;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
 
 namespace RandomizationTests.SamplerTests
 {

com.unity.perception/Tests/Runtime/Randomization/SamplerTests/FloatRangeTests.cs

 using System;
 using NUnit.Framework;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
 
 namespace RandomizationTests.SamplerTests
 {

com.unity.perception/Tests/Runtime/Randomization/SamplerTests/NormalSamplerTests.cs

 using NUnit.Framework;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
 
 namespace RandomizationTests.SamplerTests
 {

com.unity.perception/Tests/Runtime/Randomization/SamplerTests/SamplerTestsBase.cs

 using System;
 using NUnit.Framework;
 using Unity.Jobs;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
 
 namespace RandomizationTests.SamplerTests
 {

com.unity.perception/Tests/Runtime/Randomization/SamplerTests/SamplerUtilityTests.cs

 using NUnit.Framework;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
 
 namespace RandomizationTests.SamplerTests
 {

com.unity.perception/Tests/Runtime/Randomization/SamplerTests/UniformSamplerTests.cs

 using NUnit.Framework;
-using UnityEngine.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
 
 namespace RandomizationTests.SamplerTests
 {

com.unity.perception/Tests/Runtime/Randomization/ScenarioTests.cs

 using NUnit.Framework;
 using UnityEngine;
 using UnityEngine.Perception.GroundTruth;
-using UnityEngine.Perception.Randomization.Configuration;
-using UnityEngine.Perception.Randomization.Parameters;
-using UnityEngine.Perception.Randomization.Samplers;
-using UnityEngine.Perception.Randomization.Scenarios;
+using UnityEngine.Experimental.Perception.Randomization.Configuration;
+using UnityEngine.Experimental.Perception.Randomization.Parameters;
+using UnityEngine.Experimental.Perception.Randomization.Samplers;
+using UnityEngine.Experimental.Perception.Randomization.Scenarios;
 using UnityEngine.TestTools;
 using Object = UnityEngine.Object;