Device Location Category (Location)

In point devices, the Location category includes the following properties:

• Profile Elevation (GradeElevation, Double) - Elevation on the reference profile
  If the grade is not defined, this value cannot be calculated
• Surface Elevation (SurfaceElevation, Double) - Elevation on reference surface
  If the surface is not defined, this value cannot be calculated
• Station (Station, Double) - Station where the device is in relation to the reference axis
  If the axis is not defined, this value cannot be calculated/edited
  In the properties frame, you can adjust the value of the station filling in the value of the progressive, as long as the reference axis is configured:
  
  
• Offset (Offset, Double) - tells the offset of the insertion point relative to reference axis is defined
  If the axis is not defined, this value cannot be calculated/edited
  In the properties frame, you can adjust the offset value filling in, as long as the reference axis is configured, with negative values when you want the left of the axis or positive for the right side of the axis
• Location (Location, GeometryPoint) - Insertion Point. Informs the X, Y, Z coordinates of the device insertion point
  In plan view, you can modify the insertion point by dragging the grip point:

In Linear devices and longitudinal devices:

• Start Location
  • StartGradeElevation, Double - Elevation on the reference profile at the device's upstream position
    If the grade is not defined, this value cannot be calculated
  • Surface at Start (StartSurfElevation, Double) - Elevation on reference surface in the upstream position of the device
    If the surface is not defined, this value cannot be calculated
  • Start Station (StartStation, Double) - Station where the upstream is located in relation to the reference axis
    If the axis is not defined, this value cannot be calculated/edited
  • Start Offset (StartOffset, Double) - Distance where the upstream is in relation to the reference axis
    If the axis is not defined, this value cannot be calculated/edited
  • Start Position (StartPoint, GeometryPoint) - X, Y, Z coordinates of the device upstream
  • Start Connector (StartConnector, GeometryPoint) - position of the start connector, obtained from the structure where the device is connected
    For example, when we connect a pipe to a PV, this can have the connections marked in magenta below:
    
    
    
    Note that this connector is made using the tool Connector
    When the pipe connects to the PV, it will get the position (StartConnector) and direction (StartConnectorDirection) of the connector and you can use these properties in the pipe constructor to do changes, for example the cutting angle of the pipe end:
    
    
    
    In the image above, a calculation is made of the angle of the cutting plane of the pipe tip, so that it fits into the manhole wall
    Open the template design (look in the installation folder, the file catalogo_limpo.dwg) , the circular pipe shaper
  • Start Connector Filter (StartConnectorFilter, String) - Text that will be used to filter the connector when choosing the closest
    When connecting a linear device to a point device, the connection occurs at the position of the connector closer. It turns out, that not all connectors are suitable for connecting, for example, a collector box of the DER-SP standard can connect to triangular/trapezoidal pipes and ditches. These trenches are shallow, whereas the pipes are buried. In this case, the program must be able to decide if a connector is valid. Use plain text to indicate the desired connector type:
    • ditch - for ditches or gutters
    • Pipe - for Pipes
    • sink - to connect gutters to sinks
    • descent, ladder - for the case of a ditch that can connect to a point device intended to receive rapid water descent or step descent, such as the DNIT standard collection box
    Note: it is possible to use more than one code. Just separate each code by commas (example: ditch, gutter). The filter is not case sensitive, if there is no code to filter, either is considered valid.
  • Start Connector Direction (StartConnectorDirection, GeometryVector) - directional vector (normal to the plane of the point device) of the start connector
  • Start Location (StartLocation, GeometryPoint) - insertion point of the upstream device, if any, section is equal to StartPoint
    For replacement actions during rebuild, prefer to use properties that do not force the device to downgrade, or even, don't force connection between devices that get properties from each other
• End Location
  • Grade at End (EndGradeElevation, Double) - Elevation at reference profile at the downstream position of the device
    If the grade is not defined, this value cannot be calculated
  • Surface at End (EndSurfElevation, Double) - Elevation on reference surface in the downstream position of the device
    If the surface is not defined, this value cannot be calculated
  • End Station (EndStation, Double) - Station where the downstream is in relation to the reference axis
    If the axis is not defined, this value cannot be calculated/edited
  • End Offset (EndOffset, Double) - Distance where the downstream is in relation to the reference axis
    If the axis is not defined, this value cannot be calculated/edited
  • EndPoint Position (EndPoint, GeometryPoint) - X, Y, Z coordinates of downstream device
    You can change the start or end position in plan by dragging the grip points:
    
    
  • End Connector (EndConnector, GeometryPoint) - position of the connector final, obtained in the structure in which the device is connected
    The same considerations made for StartConnector apply is
  • End ConnectorFilter (EndConnectorFilter, String) - Text that will be used to filter the connector when choosing the closest
    The same considerations as for the Initial Connector Filter apply
  • End Connector Direction (EndConnectorDirection, GeometryVector) - directional vector (normal to the point device plane) of the end connector
    The same considerations made for StartConnectorDirection apply
  • End Location (EndLocation, GeometryPoint) - insertion point of the downstream device, if any, section is equal to StartPoint