Class Alignments

Contains static methods for execution of WisDOT Alignment tools.

Namespace: WisDOT

Assembly: WisDOT.Extensions.dll

Methods

AdjustSuperelevationRunout()

Update alignment superelevation values to accommodate WisDOT design standards.

Declaration

public static void AdjustSuperelevationRunout()

Remarks

Civil 3D extends the runout through the shoulders. WisDOT shoulders runout transition stations are identical to the lane runout stations.

https://c3dkb.dot.wi.gov/Content/c3d/wisdot-cstm/c3d-tab/dsn/dsn-ali-adjst-suprelvatn-rnout.htm

AssignAlignmentStyles(string)

Assigns alignment styles and alignment label set styles based on the alignment name.

Declaration

public static void AssignAlignmentStyles(string defaultCsv)

Parameters

Type	Name	Description
string	defaultCsv	A default .csv file that maps alignment names to styles using wildcards. Example format: ETW,RDWY Lane Edge,_No Labels

Remarks

https://c3dkb.dot.wi.gov/Content/c3d/wisdot-cstm/c3d-tab/dsn/dsn-ali-asign-ali-styl.htm

CheckIntersectionSightDistance(string, double)

Checks the clear sight window for Intersection Sight Distance utilizing input options for decision point location, eye height, required sight distance, target vehicle path, and terrain surface.

Declaration

public static void CheckIntersectionSightDistance(string helpKey, double objectHeight = 3.5)

Parameters

Type	Name	Description
string	helpKey	The command name used to execute this method. This is used to look up the help url in the /en-US/HelpResources.csv
double	objectHeight	The object height (ft) used for the analysis.

Remarks

https://c3dkb.dot.wi.gov/Content/c3d/wisdot-cstm/c3d-tab/dsn/anlyz-viz-chk-prfl-sit-dstnc.htm

CheckProfileSightDistance(string, double)

Checks for sight distance obstructions along a profile utilizing input parameters for object height and required stopping, decision or passing sight distance.

Declaration

public static void CheckProfileSightDistance(string helpKey, double eyeHeight = 3.5)

Parameters

Type	Name	Description
string	helpKey	The command name used to execute this method. This is used to look up the help url in the /en-US/HelpResources.csv
double	eyeHeight	The eye height (ft) used for the analysis.

Remarks

https://c3dkb.dot.wi.gov/Content/c3d/wisdot-cstm/c3d-tab/dsn/anlyz-viz-chk-prfl-sit-dstnc.htm

CheckSightDistance(string, double)

Checks for sight distance obstructions along a profile utilizing input parameters for object height and required stopping, decision or passing sight distance.

Declaration

public static void CheckSightDistance(string helpKey, double eyeHeight = 3.5)

Parameters

Type	Name	Description
string	helpKey	The command name used to execute this method. This is used to look up the help url in the /en-US/HelpResources.csv
double	eyeHeight	The eye height (ft) used for the analysis.

Remarks

https://c3dkb.dot.wi.gov/Content/c3d/wisdot-cstm/c3d-tab/dsn/anlyz-viz-chk-prfl-sit-dstnc.htm

CreateAlignmentFromSDMSPCPTAli(string, string, string)

Imports SDMS .ali files that are PC/PT defined and creates an Civil 3D alignment with an assigned style and label set.

Declaration

public static void CreateAlignmentFromSDMSPCPTAli(string helpKey, string defaultStyle = "ALI Proposed", string defaultLabelSet = "1IN 100FT-Ticks 200' Major:100' Minor")

Parameters

Type	Name	Description
string	helpKey	The command name used to execute this method. This is used to look up the help url in the /en-US/HelpResources.csv
string	defaultStyle	The default alignment style name to be listed in the style combobox.
string	defaultLabelSet	The default label set style name to be listed in the label set combobox.

Remarks

https://c3dkb.dot.wi.gov/Content/c3d/wisdot-cstm/c3d-tab/srvy/srvy-imprt-pcpt-ali-fil.htm

CreateAlignmentFromSDMSPIAli(string, string, string)

Imports SDMS .ali files that are PI defined and creates an Civil 3D alignment with an assigned style and label set.

Declaration

public static void CreateAlignmentFromSDMSPIAli(string helpKey, string defaultStyle = "ALI Proposed", string defaultLabelSet = "1IN 100FT-Ticks 200' Major:100' Minor")

Parameters

Type	Name	Description
string	helpKey	The command name used to execute this method. This is used to look up the help url in the /en-US/HelpResources.csv
string	defaultStyle	The default alignment style name to be listed in the style combobox.
string	defaultLabelSet	The default label set style name to be listed in the label set combobox.

Remarks

https://c3dkb.dot.wi.gov/Content/c3d/wisdot-cstm/c3d-tab/srvy/srvy-imprt-pi-ali-fil.htm

CreateAlignmentsFromBeamguardBlock()

Creates miscellaneous alignment objects from the WisDOT MGS beam guard EAT blocks for use in corridor targeting. Alignment names, layers, and styles are all preset to standard values.

Declaration

public static void CreateAlignmentsFromBeamguardBlock()

Remarks

Requires the use of WisDOT beam guard blocks.

https://c3dkb.dot.wi.gov/Content/c3d/wisdot-cstm/c3d-tab/dsn/dsn-ali-creat-ali-bg-blk.htm

CreateAlignmentsFromIntersectionBlock()

Creates miscellaneous alignment objects from the WisDOT intersection blocks (based on SDD 9A1 At-Grade Side Road Intersections). Alignment names, layers, and styles are all preset to standard values.

Declaration

public static void CreateAlignmentsFromIntersectionBlock()

Remarks

Requires the use of WisDOT intersection blocks

https://c3dkb.dot.wi.gov/Content/c3d/wisdot-cstm/c3d-tab/dsn/dsn-ali-creat-ali-intrsctn-blk.htm

CreateCurbOffsetAlignments(string, string)

Automates the creation of offset alignments representing curb and gutter Face and Back alignments.

Declaration

public static void CreateCurbOffsetAlignments(string faceStyle = "RDWY Curb&Gutter Face", string backStyle = "RDWY Curb&Gutter Back")

Parameters

Type	Name	Description
string	faceStyle	Aligment style name for the face of curb. If the style is not found, the first style in the alignment style collection is used.
string	backStyle	Alignment style name for the back of curb. If the style is not found, the first style in the alignment style collection is used.

Remarks

https://c3dkb.dot.wi.gov/Content/c3d/wisdot-cstm/c3d-tab/dsn/dsn-ali-creat-crb-ofst.htm

CreateStaIncLbls()

Places alignment labels along offset objects based on an increment of an alignment.

Declaration

public static void CreateStaIncLbls()

Remarks

https://c3dkb.dot.wi.gov/Content/c3d/wisdot-cstm/c3d-tab/sht/sht-creatn-tl-sta-inc-lbl.htm

FlipAlignmentLabels()

Flips all alignment labels to opposite side

Declaration

public static void FlipAlignmentLabels()

Remarks

GetAlignmentIdByName(string)

Get an alignment ObjectId from its name

Declaration

public static ObjectId GetAlignmentIdByName(string name)

Parameters

Type	Name	Description
string	name	Alignment name

Returns

Type	Description
ObjectId	ObjectId of alignment

GetAlignmentNames(bool)

Get a list of alignment names with option to only return those with superelevation

Declaration

public static List<string> GetAlignmentNames(bool superelevationOnly)

Parameters

Type	Name	Description
bool	superelevationOnly	Return superelevation alignments only

Returns

Type	Description
List<string>	List of alignment names

GetRawStation(ObjectId, double, string, string, bool, bool)

Get the alignment raw station value from the station with equations value

Declaration

public static double GetRawStation(ObjectId alignId, double station, string conflictTitle, string conflictLabel, bool skipConflict = false, bool returnLimitsWhenExceeded = false)

Parameters

Type	Name	Description
ObjectId	alignId	ObjectId of alignment
double	station	Station with equations
string	conflictTitle	When more than one raw station is possible raise dialog with this title
string	conflictLabel	When more than one raw station is possible raise dialog with this label
bool	skipConflict	If more than one raw station is possible return Double.NaN
bool	returnLimitsWhenExceeded	If raw station exeeds the alignment station limits, return the nearest station limit

Returns

Type	Description
double	Raw station

GetStationWithEqAndPrecision(ObjectId, double, int, bool)

Get an alignment station string with equations at the specified precision

Declaration

public static string GetStationWithEqAndPrecision(ObjectId alignmentId, double station, int precision, bool returnLimitsWhenExceeded = false)

Parameters

Type	Name	Description
ObjectId	alignmentId	ObjectId of aligment
double	station	Raw station
int	precision	Number of decimal places to include in the string
bool	returnLimitsWhenExceeded	If raw station exeeds the alignment station limits, return the nearest station limit

Returns

Type	Description
string	station string

GetStationWithEqAndPrecision(string, double, int, bool)

Get an alignment station string with equations at the specified precision

Declaration

public static string GetStationWithEqAndPrecision(string alignmentName, double station, int precision, bool returnLimitsWhenExceeded = false)

Parameters

Type	Name	Description
string	alignmentName	Alignment name
double	station	Raw station
int	precision	Number of decimal places to include in the string
bool	returnLimitsWhenExceeded	If raw station exeeds the alignment station limits, return the nearest station limit

Returns

Type	Description
string	station string

SelectStationOffset(string, string)

Prompt user to click a location and return a station/offset

Declaration

public static double[] SelectStationOffset(string message, string alignmentName)

Parameters

Type	Name	Description
string	message	Command line message to instruct user
string	alignmentName	Reference alignment name

Returns

Type	Description
double[]	Double array containg the selected station and offset