habitat.config.default_structured_configs module

Classes

class HabitatConfig
The entry point for the configuration of Habitat. It holds the environment, simulator, task and dataset configurations.
class DatasetConfig
Configuration for the dataset of the task.
class TaskConfig
The definition of the task in Habitat.
class EnvironmentConfig
Some habitat environment configurations.
class StopActionConfig
In Navigation tasks only, the stop action is a discrete action. When called, the Agent will request to stop the navigation task. Note that this action is needed to succeed in a Navigation task since the Success is determined by the Agent calling the stop action within range of the target. Note that this is different from the RearrangeStopActionConfig that works for Rearrangement tasks only instead of the Navigation tasks.
class MoveForwardActionConfig
In Navigation tasks only, this discrete action will move the robot forward by a fixed amount determined by the SimulatorConfig.forward_step_size amount.
class TurnLeftActionConfig
In Navigation tasks only, this discrete action will rotate the robot to the left by a fixed amount determined by the SimulatorConfig.turn_angle amount.
class TurnLeftActionConfig
In Navigation tasks only, this discrete action will rotate the robot to the left by a fixed amount determined by the SimulatorConfig.turn_angle amount.
class TurnRightActionConfig
In Navigation tasks only, this discrete action will rotate the robot to the right by a fixed amount determined by the SimulatorConfig.turn_angle amount.
class LookUpActionConfig
In Navigation tasks only, this discrete action will rotate the robot’s camera up by a fixed amount determined by the SimulatorConfig.tilt_angle amount.
class LookDownActionConfig
In Navigation tasks only, this discrete action will rotate the robot’s camera down by a fixed amount determined by the SimulatorConfig.tilt_angle amount.
class NumStepsMeasurementConfig
In both Navigation and Rearrangement tasks, counts the number of steps since the start of the episode.
class DistanceToGoalMeasurementConfig
In Navigation tasks only, measures the geodesic distance to the goal.
class SuccessMeasurementConfig
For Navigation tasks only, Measures 1.0 if the robot reached a success and 0 otherwise. A success is defined as calling the StopAction when the DistanceToGoal Measure is smaller than success_distance.
class SPLMeasurementConfig
For Navigation tasks only, Measures the SPL (Success weighted by Path Length) ref: On Evaluation of Embodied Agents - Anderson et. al https://arxiv.org/pdf/1807.06757.pdf Measure is always 0 except at success where it will be the ratio of the optimal distance from start to goal over the total distance traveled by the agent. Maximum value is 1. SPL = success * optimal_distance_to_goal / distance_traveled_so_far
class SoftSPLMeasurementConfig
For Navigation tasks only, Similar to SPL, but instead of a boolean, success is now calculated as 1 - (ratio of distance covered to target). SoftSPL = max(0, 1 - distance_to_goal / optimal_distance_to_goal) * optimal_distance_to_goal / distance_traveled_so_far
class DistanceToGoalRewardMeasurementConfig
In Navigation tasks only, measures a reward based on the distance towards the goal. The reward is - (new_distance - previous_distance) i.e. the decrease of distance to the goal.
class ObjectGoalSensorConfig
For Object Navigation tasks only. Generates a discrete observation containing the id of the goal object for the episode.
class InstanceImageGoalSensorConfig
Used only by the InstanceImageGoal Navigation task. The observation is a rendered image of the goal object within the scene.
class InstanceImageGoalHFOVSensorConfig
Used only by the InstanceImageGoal Navigation task. The observation is a single float value corresponding to the Horizontal field of view (HFOV) in degrees of the image provided by the InstanceImageGoalSensor.
class CompassSensorConfig
For Navigation tasks only. The observation of the EpisodicCompassSensor is a single float value corresponding to the angle difference in radians between the current rotation of the robot and the start rotation of the robot along the vertical axis.
class GPSSensorConfig
For Navigation tasks only. The observation of the EpisodicGPSSensor are two float values corresponding to the vector difference in the horizontal plane between the current position and the start position of the robot (in meters).
class PointGoalWithGPSCompassSensorConfig
Indicates the position of the point goal in the frame of reference of the robot.
class HumanoidDetectorSensorConfig
Check if the human is in frame
class ArmDepthBBoxSensorConfig
Bounding box sensor to check if the object is in frame
class SpotHeadStereoDepthSensorConfig
For Spot only. Sensor fusion for inputs of Spot stereo pair depth sensor
class EmptyActionConfig
In Navigation tasks only, the pass action. The robot will do nothing.
class ArmActionConfig
In Rearrangement tasks only, the action that will move the robot arm around. The action represents to delta angle (in radians) of each joint.
class BaseVelocityActionConfig
In Rearrangement only. Corresponds to the base velocity. Contains two continuous actions, the first one controls forward and backward motion, the second the rotation.
class HumanoidJointActionConfig
In Rearrangement only. Corresponds to actions to change the humanoid joints. Contains the parameter num_joints, indicating the joints that can be modified.
class HumanoidPickActionConfig
In rearrangement tasks only. Config for humanoid to reach objects using IK. For now only contains the number of joints. May be extended with duration of action
class RearrangeStopActionConfig
In rearrangement tasks only, if the robot calls this action, the task will end.
class OracleNavActionConfig
Rearrangement Only, Oracle navigation action. This action takes as input a discrete ID which refers to an object in the PDDL domain. The oracle navigation controller then computes the actions to navigate to that desired object.
class SelectBaseOrArmActionConfig
In rearrangement tasks only, if the robot calls this action, the task will end.
class RelativeRestingPositionSensorConfig
Rearrangement only. Sensor for the relative position of the end-effector’s resting position, relative to the end-effector’s current position. The three values correspond to the cartesian coordinates of the resting position in the frame of reference of the end effector. The desired resting position is determined by the habitat.task.desired_resting_position coordinates relative to the robot’s base.
class IsHoldingSensorConfig
Rearrangement only. A single float sensor with value 1.0 if the robot is grasping any object and 0.0 otherwise.
class EEPositionSensorConfig
Rearrangement only. the cartesian coordinates (3 floats) of the arm’s end effector in the frame of reference of the robot’s base.
class JointSensorConfig
Rearrangement only. Returns the joint positions of the robot.
class HumanoidJointSensorConfig
Rearrangement only. Returns the joint positions of the robot.
class TargetStartSensorConfig
Rearrangement only. Returns the relative position from end effector to a target object that needs to be picked up.
class GoalSensorConfig
Rearrangement only. Returns the relative position from end effector to a goal position in which the agent needs to place an object.
class TargetStartGpsCompassSensorConfig
Rearrangement only. Returns the initial position of every object that needs to be rearranged in composite tasks, in 2D polar coordinates.
class InitialGpsCompassSensorConfig
Rearrangement only. Returns the relative distance to the initial starting location of the agent in 2D polar coordinates.
class TargetGoalGpsCompassSensorConfig
Rearrangement only. Returns the desired goal position of every object that needs to be rearranged in composite tasks, in 2D polar coordinates.
class EndEffectorToRestDistanceMeasurementConfig
Rearrangement only. Distance between current end effector position and the resting position of the end effector. Requires that the RelativeRestingPositionSensor is attached to the agent.
class RobotForceMeasurementConfig
The amount of force in newton’s applied by the robot. It computes both the instant and accumulated.
class DoesWantTerminateMeasurementConfig
Rearrangement Only. Measures 1 if the agent has called the stop action and 0 otherwise.
class ForceTerminateMeasurementConfig
If the force is greater than a certain threshold, this measure will be 1.0 and 0.0 otherwise. Note that if the measure is 1.0, the task will end as a result.
class ObjectToGoalDistanceMeasurementConfig
In rearrangement only. The distance between the target object and the goal position for the object.
class ObjAtGoalMeasurementConfig
The measure is a dictionary of target indexes to float. The values are 1 if the object is within succ_thresh of the goal position for that object.
class ArtObjAtDesiredStateMeasurementConfig
Rearrangement open/close container tasks only. Whether the articulated object (fridge or cabinet door) towards a desired state (open or closed) as defined by the task.
class RotDistToGoalMeasurementConfig
Rearrangement Navigation task only. The angle between the forward direction of the agent and the direction to the goal location.
class PddlStageGoalsMeasurementConfig
PDDL Rearrangement only. 1.0 if the agent complete a particular stage defined in stage_goals and 0.0 otherwise. Stage goals are specified in the pddl task description.
class NavToPosSuccMeasurementConfig
Rearrangement Navigation task only. The value is 1.0 if the robot is within success_distance of the goal position.
class SocialNavStatsMeasurementConfig
Social nav stats computation
class NavSeekSuccessMeasurementConfig
Social nav seek success measurement
class RearrangePickSuccessMeasurementConfig
Rearrangement Only. Requires the end_effector_sensor lab sensor. 1.0 if the robot picked the target object.
class RearrangePickRewardMeasurementConfig
Rearrangement Only. Requires the end_effector_sensor lab sensor. The reward for the pick task.
class PlaceSuccessMeasurementConfig
Rearrangement Only. Requires the end_effector_sensor lab sensor. 1.0 if the robot placed the target object on the goal position and has its end effector within ee_resting_success_threshold of its resting position.
class PlaceRewardMeasurementConfig
Rearrangement Only. Requires the end_effector_sensor lab sensor. The reward for the place task.
class ArtObjSuccessMeasurementConfig
Rearrangement open/close container tasks only. Requires art_obj_at_desired_state. Is 1.0 if the articulated object is in desired state and the end effector is within rest_dist_threshold of the resting position. If must_call_stop is True, the robot must also call the rearrange_stop action.
class ArtObjRewardMeasurementConfig
Rearrangement open/close container tasks only. Requires art_obj_at_desired_state.
class NavToObjSuccessMeasurementConfig
Rearrangement Navigation only. Takes the value 1.0 when the Robot successfully navigated to the target object. Depends on nav_to_pos_succ.
class NavToObjRewardMeasurementConfig
Rearrangement Navigation task only. The reward for rearrangement navigation.
class PddlSuccessMeasurementConfig
PDDL rearrangement tasks only (rearrange, set_table, tidy_house). It uses a goal pddl expression to validate the success.
class RuntimePerfStatsMeasurementConfig
If added to the measurements, this will time various sections of code in the simulator and task logic. If using with a multi-environment trainer (like DD-PPO) it is recommended to only log this stat for one environment since this metric can include many numbers.