LineOfSightOperator.CarrierType Property

Gets or sets an enumeration value, telling if the observer is ground-based or airborne.

Syntax

public AttributeVariable< CarrierType > CarrierType { get; set; }

Property Value

Type: An attribute variable that returns a value of type CarrierType.
Default: GroundBased
Specifies whether the observer is ground-based or airborne.

Remarks

If GroundBased, the sensor will be placed SensorHeight above ground, and the z value of the observer feature will be ignored.
If Airborne, the sensor will be placed SensorHeight above an airborne carrier, whose altitude depends on the z value of the observer feature. The meaning of z is given by the ObserverHeightType, which can be AboveSeaLevel, AboveGround, or AboveTreetops.

To the right in the image, the ObserverHeightType is AboveGround.

Remember that the SensorHeight and the z value is expressed in the VerticalUnit.

Example

// Configure LineOfSightOperator for an Airplane with the camera directed straight down, 
// giving a picture that covers 10 degrees fore-to-aft and 20 degrees port-to-starboard
public static void ConfigureLineOfSightOperatorForAirplaneCamera(
    LineOfSightOperator lineOfSightOperator)
{
    // This property is a member of a type that might be referred to by a View 
    // or a GlobeView, either directly or indirectly through other objects, which means 
    // that you must use the Guard class to take the global configuration lock when it 
    // is modified to synchronize access with any running Carmenta Engine threads.
    using (Guard guard = new Guard())
    {
        // Set the CarrierType to airborne
        lineOfSightOperator.CarrierType = CarrierType.Airborne;

        // Set the PictureDirection to starboard. This is 90 degrees clockwise from the course, 
        // which we assume is available from a Course attribute.
        lineOfSightOperator.PictureDirection = 
            new ExpressionAttributeVariable<double>(
                "if Course != null then Course + 90.0 else 90.0");

        // Set the Picture elevation to the Roll attribute minus 90 degrees 
        // (we assume that positive roll means starboard up). 
        lineOfSightOperator.PictureElevation = 
            new ExpressionAttributeVariable<double>(
                "if Roll != null then Roll - 90.0 else - 90.0");

        // Set the PictureHeight to 20 degrees
        lineOfSightOperator.PictureHeight = 20.0;

        // Set the PictureWidth to 10 degrees
        lineOfSightOperator.PictureWidth = 10.0;

        // Set the VerticalUnit to Meter (Default is Meter)
        lineOfSightOperator.VerticalUnit = LengthUnit.Meter;

        // Set the VerticalRotationAxis to false, since this is not a radar system 
        // that rotates around a vertical axis, but a fixed camera.
        lineOfSightOperator.VerticalRotationAxis = false;
    }
}

Platforms

Windows, Linux, Android

LineOfSightOperator::carrierType Property

Gets or sets an enumeration value, telling if the observer is ground-based or airborne.

Syntax

C++

public:
CarrierTypeAttributeVariablePtr carrierType ( ) const;
void carrierType ( const CarrierTypeAttributeVariablePtr& value )

Property Value

Type: An attribute variable that returns a value of type CarrierType.
Default: CarrierTypeGroundBased
Specifies whether the observer is ground-based or airborne.

Remarks

If GroundBased, the sensor will be placed sensorHeight above ground, and the z value of the observer feature will be ignored.
If Airborne, the sensor will be placed sensorHeight above an airborne carrier, whose altitude depends on the z value of the observer feature. The meaning of z is given by the observerHeightType, which can be AboveSeaLevel, AboveGround, or AboveTreetops.

To the right in the image, the observerHeightType is AboveGround.

Remember that the sensorHeight and the z value is expressed in the verticalUnit.

Example

C++

// Configure LineOfSightOperator for an Airplane with the camera directed straight down, 
// giving a picture that covers 10 degrees fore-to-aft and 20 degrees port-to-starboard
static void configureLineOfSightOperatorForAirplaneCamera(
    LineOfSightOperatorPtr lineOfSightOperator)
{ 
    // This property is a member of a type that might be referred to by a View 
    // or a GlobeView, either directly or indirectly through other objects, which means 
    // that you must use the Guard class to take the global configuration lock when it 
    // is modified to synchronize access with any running Carmenta Engine threads.
    Guard guard;

    // Set the CarrierType to airborne
    lineOfSightOperator->carrierType(
        new DirectCarrierTypeAttributeVariable(CarrierTypeAirborne));

    // Set the PictureDirection to starboard. This is 90 degrees clockwise from the course, 
    // which we assume is available from a Course attribute.
    lineOfSightOperator->pictureDirection(
        new ExpressionDoubleAttributeVariable(
            "if Course != null then Course + 90.0 else 90.0"));

    // Set the Picture elevation to the Roll attribute minus 90 degrees
    // (we assume that positive roll means starboard up). 
    lineOfSightOperator->pictureElevation(
        new ExpressionDoubleAttributeVariable(
            "if Roll != null then Roll - 90.0 else - 90.0"));

    // Set the PictureHeight to 20 degrees
    lineOfSightOperator->pictureHeight(new DirectDoubleAttributeVariable(20.0));

    // Set the PictureWidth to 10 degrees
    lineOfSightOperator->pictureWidth(new DirectDoubleAttributeVariable(10.0));

    // Set the VerticalUnit to Meter (Default is Meter)
    lineOfSightOperator->verticalUnit(LengthUnit::meter());
   
    // Set the VerticalRotationAxis to false, since this is not a radar system 
    // that rotates around a vertical axis, but a fixed camera.
    lineOfSightOperator->verticalRotationAxis(new DirectBoolAttributeVariable(false));
}

Platforms

Windows, Linux, Android

LineOfSightOperator.carrierType Property

Gets or sets an enumeration value, telling if the observer is ground-based or airborne.

Syntax

Java

public final CarrierTypeAttributeVariable getCarrierType ( );
public final void setCarrierType ( CarrierTypeAttributeVariable value );

Property Value

Type: An attribute variable that returns a value of type CarrierType.
Default: GROUNDBASED
Specifies whether the observer is ground-based or airborne.

Remarks

If GroundBased, the sensor will be placed sensorHeight above ground, and the z value of the observer feature will be ignored.
If Airborne, the sensor will be placed sensorHeight above an airborne carrier, whose altitude depends on the z value of the observer feature. The meaning of z is given by the observerHeightType, which can be AboveSeaLevel, AboveGround, or AboveTreetops.

To the right in the image, the observerHeightType is AboveGround.

Remember that the sensorHeight and the z value is expressed in the verticalUnit.

Example

Java

// Configure LineOfSightOperator for an Airplane with the camera directed straight down, 
// giving a picture that covers 10 degrees fore-to-aft and 20 degrees port-to-starboard
public static void configureLineOfSightOperatorForAirplaneCamera(
    LineOfSightOperator lineOfSightOperator)
{
    // This property is a member of a type that might be referred to by a View 
    // or a GlobeView, either directly or indirectly through other objects, which means 
    // that you must use the Guard class to take the global configuration lock when it 
    // is modified to synchronize access with any running Carmenta Engine threads.
    Guard guard = new Guard();
    try
    {
        // Set the CarrierType to airborne
        lineOfSightOperator.setCarrierType(
            new DirectCarrierTypeAttributeVariable(CarrierType.AIRBORNE));

        // Set the PictureDirection to starboard. This is 90 degrees clockwise from the course, 
        // which we assume is available from a Course attribute.
        lineOfSightOperator.setPictureDirection(
            new ExpressionDoubleAttributeVariable(
                "if Course != null then Course + 90.0 else 90.0"));

        // Set the Picture elevation to the Roll attribute minus 90 degrees 
        // (we assume that positive roll means starboard up). 
        lineOfSightOperator.setPictureElevation(
            new ExpressionDoubleAttributeVariable(
                "if Roll != null then Roll - 90.0 else - 90.0"));

        // Set the PictureHeight to 20 degrees
        lineOfSightOperator.setPictureHeight(new DirectDoubleAttributeVariable(20.0));

        // Set the PictureWidth to 10 degrees
        lineOfSightOperator.setPictureWidth(new DirectDoubleAttributeVariable(10.0));

        // Set the VerticalUnit to Meter (Default is Meter)
        lineOfSightOperator.setVerticalUnit(LengthUnit.getMeter());

        // Set the VerticalRotationAxis to false, since this is not a radar system 
        // that rotates around a vertical axis, but a fixed camera.
        lineOfSightOperator.setVerticalRotationAxis(new DirectBoolAttributeVariable(false));
    }
    finally
    {
        guard.dispose();
    }
}

Platforms

Windows, Linux, Android

LineOfSightOperator.carrierType Property

Gets or sets an enumeration value, telling if the observer is ground-based or airborne.

Syntax

Python

carrierType

Property Value

Type: An attribute variable that returns a value of type CarrierType.
Default: CarrierType.GroundBased
Specifies whether the observer is ground-based or airborne.

Remarks

If GroundBased, the sensor will be placed sensorHeight above ground, and the z value of the observer feature will be ignored.
If Airborne, the sensor will be placed sensorHeight above an airborne carrier, whose altitude depends on the z value of the observer feature. The meaning of z is given by the observerHeightType, which can be AboveSeaLevel, AboveGround, or AboveTreetops.

To the right in the image, the observerHeightType is AboveGround.

Remember that the sensorHeight and the z value is expressed in the verticalUnit.

Example

Python

# This example is not available in the selected language.

Platforms

Windows, Linux, Android

LineOfSightOperator.CarrierType Property

In this article

Syntax

Property Value

Remarks

Example

Platforms

See Also

Reference

LineOfSightOperator::carrierType Property

In this article

Syntax

Property Value

Remarks

Example

Platforms

See Also

Reference

LineOfSightOperator.carrierType Property

In this article

Syntax

Property Value

Remarks

Example

Platforms

See Also

Reference

LineOfSightOperator.carrierType Property

In this article

Syntax

Property Value

Remarks

Example

Platforms

See Also

Reference