This file is indexed.

/usr/share/xtrkcad/html/cmdProfile.html is in xtrkcad 1:4.0.2-2ubuntu1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=US-ASCII">
<title>Profile</title>
<link rel="previous" href="cmdMoveLabel.html">
<link rel="ToC" href="contents.html">
<link rel="index" href="IndexPage.html">
<link rel="next" href="cmdDescribe.html">
<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head>
<body>
<h1><a name="cmdProfile"></a>2.2.10 Profile</h1>
<p>
The <strong>Profile</strong> dialog draws a profile showing elevations, distances and grades for a path on the layout.
</p>
<p>
<img src="png.d/dcprofile.png">
</p>
<p>
Choose a path by using <em>Left-Click</em> on endpoints. As each endpoint is chosen, the path is extended via the shortest route. Selecting the end of the path trims the path back to a last <strong>Defined Elevation</strong> point (if any, otherwise the path is cleared).
</p>
<p>
If no route is possible an error message is displayed. There are several reasons why this might happen:
</p>
<ul><li>
The tracks are not connected. Check this by using <em>Shift+Left-Click</em> on one track using the <strong>Select</strong> command (<a href="cmdSelect.html#cmdSelect">Section 2.2.14</a>). This selects all tracks connected (directly or indirectly). See if the other track is selected.
</li>
</ul>
<p>

</p>
<ul><li>
One of the endpoints on the route is <strong>Ignored</strong> (<a href="cmdElev.html#cmdElev">Section 2.2.4</a>). Look for blue dots on the expected path when using the Profile or <strong>Elevation</strong> (<a href="cmdElev.html#cmdElev">Section 2.2.4</a>) commands.
</li>
</ul>
<p>

</p>
<ul><li>
The only route connects to a section of track that is already on the path and is not the end of the path. Remove the end of the path until the connected track is not on the path.
</li>
</ul>
<p>
The path is drawn in the Profile Color (<a href="cmdRgbcolor.html#cmdRgbcolor">Section 2.10.1</a>) (default Purple) on the layout.
</p>
<p>
If the shortest path is not what you want, you can choose endpoints that are closer to the end of the path. Also, you can <strong>Ignore</strong> (<a href="cmdElev.html#cmdElev">Section 2.2.4</a>) endpoints to prevent the path from choosing a route through that endpoint. Shift+Right-Click (<a href="cmdAcclKeys.html#cmdAcclKeys">Section 3.4</a>) displays a pop-up menu that allows you to change the specified endpoint to be a <strong>Defined</strong>, <strong>Ignored</strong> or <strong>None</strong> Elevation endpoint.
</p>
<p>
Each <strong>Defined Elevation</strong> endpoint on the path is drawn as a Vertical bar, labeled with its height and distance from the beginning of the path.
</p>
<p>
The <strong>Grade</strong> between points is displayed between the vertical bars. The <strong>Grade</strong> line is drawn in Blue if that portion of the path does not contain more than one Shortest Path between Defined Elevation endpoints. Otherwise it is drawn in Red, to indicate the grade is an average and the actual grade may vary for any particular track segment. See Computing Dynamic Elevation (<a href="computeElevations.html#computeElevations">Section 2.2.4.1</a>) for more details.
</p>
<p>
<strong>Stations</strong> on the path are displayed along the bottom of the <strong>Profile</strong>.
</p>
<p>
The heights of <strong>Defined Elevations</strong> can be changed by using <em>Left+Drag</em> on the profile window. As you <strong>Drag</strong>, the new elevation and grades to each side are displayed at the bottom of the profile dialog.
</p>
<p>
The <strong>Done</strong> button closes the dialog.
</p>
<p>
The <strong>Clear</strong> button preserves elevation settings established along the current profile path, removes all profile points and leaves the <strong>Profile</strong> dialog open for selection of the next set of profile points. This function is useful when there's a need to view elevations along multiple profile paths.
</p>
<p>
The <strong>Print</strong> button prints the dialog. The aspect ratio is preserved on the print-out. You will probably want to print in landscape format.
</p>
<hr>

</body>
</html>