CadTools Reference Manual
CadTools Reference Manual
CadTools Reference Manual
2010-01-17
General ................................................................................................................................................... 6
Aboutperformance...............................................................................................................................................................6 AboutCadTools.....................................................................................................................................................................6 Settings..................................................................................................................................................................................7 UserSettings..........................................................................................................................................................................9 SettingsformforCoordinategrid........................................................................................................................................10
General
Point/Circles commands..................................................................................................................... 59
Annotatepoint....................................................................................................................................................................59 Annotatepointelevation....................................................................................................................................................59 Sendsinglepointtoclipboard.............................................................................................................................................59 ExportpointandcirclestoExcel .........................................................................................................................................59 .
General
TrianglevolumebyElevation..............................................................................................................................................78 Profiledmodel.....................................................................................................................................................................79 Surfacecontours..................................................................................................................................................................81 AnnotatebyFence..............................................................................................................................................................82 Howtosmooththecontourlines........................................................................................................................................82 Surfacecrosssections..........................................................................................................................................................83 Displayreferences...............................................................................................................................................................83 Cutandfill...........................................................................................................................................................................84 CustomizeCrossSectionlayout(indrawing)......................................................................................................................85 AdvanceduseofSurfaceCrossSections.............................................................................................................................86 Surfaceprofile.....................................................................................................................................................................86 Displayreferences...............................................................................................................................................................86 Viewslopevectors ..............................................................................................................................................................89 .
General
CadTools (ToolBox) is developed for Civil Engineers using AutoCAD. There is a number of great software on the market that supports the design process for roads, rails etc. The final design of the drawing is often left for the user without any support other than AutoCADs usual tools and commands. In the beginning CadTools was designed to support slope calculation (drainage). Since the first version, over 50 useful commands have been added. Some commands have extra functionality limited for unregistered users, to become a registered user and get access to all you must donate. Almost all commands are developed for 3D, the main reason for this is that it's fun to create design models in real 3D. Using Autocads Orbit command to examine the final design gives a good idea of how it's going to look when it's built. I've seen some software doing the job in 2D but I never understood why. I work as a civil engineer with special knowledge in pavement design and evaluation, through the years I've developed software to make my work easier. I've spent thousands of hours developing software to do what I want, my conclusion is that software developed by users can be a god complement to more sophisticated software. If you should ask me -what is the best civil software on the market today? My answer should be Bentley's InRoads.
CadTools provides several other useful commands. The most common commands can be reached by a toolbar placed at the top. The software runs in two modes, Slope or Tools. If mode is set to Tools all input-boxes and toolbars for drainage support are hidden.
Decimal separator for input values in CadTools should be same as operating system settings (Control panel). All commands are developed for use in ModelSpace, some might even work in PaperSpace. This software is distributed "as is", use it at your own risk.
About performance
All commands in CadTools are based on basic geometric formulas with no optimizing techniques. Surface triangles are saved in a very simple way with no information of related triangles (nearest neighbor). A very time consuming part is plotting to Autocad, as result of all this many commands can be very slow, you could divide huge surfaces in smaller to improve performance. I myself prefer to grab a cup of coffee and let CadTools do the work.
About CadTools
CadTools is developed by Glamsen Software (www.glamsen.se) and is distributed free. Some commands and features are limited for unregistered user. To become a registered user and get access to all commands you must donate. There are no limits for donations, the result is the same (full access).
Settings
The settings form is activated through the Settings menu in Main Form.
Layers Settings Uncheck this if you have many layers in the drawing and want to speed up loading forms. You can always use CTRL+R to read layers from the current drawing to the listbox at any time, or use the object picker (button with hair-cross) Result to SpreadSheet This is a option to use a simple built in SpreadSheet instead of Excel. Use this if your computer doesn't have Excel installed. Data from the output window can be copied and pasted to other Windows software (Open Office) Autocad version Set appropriate Autocad version by selecting version from the list. The first option in the list is "Manually (type in self)", this option is useful if by any reasons development of CadTools is halted and there are newer versions of AutCAD on the market. It would be nice if you could continue to use CadTools on coming AutoCAD versions. What shall i type in? The string (reference to COM object) used by CadTools depends on AutoCAD versions. Generally you need to change the three last digits so it match your AutoCAD version, the list below may be useful along with some "try and error". AutoCAD version 2000 2002 2004 2005 2006 2007 2008 2009 2010 Reference string AutoCad.Application.15 AutoCad.Application.15.1 AutoCad.Application.16 AutoCad.Application.16.1 AutoCad.Application.16.2 AutoCad.Application.17 AutoCad.Application.17.1 AutoCad.Application.17.2 AutoCad.Application.18
Chord Height. Specifies the largest distance between a chord and the arc. This parameter is used to control the number of points along a curve that are added when converted to 3D polyline. If your value is to small no converting is performed. The default value is 0,05 (if you use meter that results in a accuracy of 5 cm) Report and temporary files folder. Specifies folder for reports (triangle volume). If you are having problems with report files it can help if you select a folder where you have read and write access. Remember to copy your UDS-file (User Defined Settings) to your new folder. This can be done by clicking on the blue text at the bottom of the form. Any existing UDS-file in the folder will not be overwritten.
Save response to Clipboard copies the formatted response-string to Windows clipboard and can be pasted in to any other Windows application Draw picked line draws a line from picked start point to picked endpoint. (current layer) Arrow Draws an arrow sign indicating slope direction. (current layer) Color Set color for line and arrow Show history Toggles history list on/off. All previous calculated values in this session is presented in a list, most recent is shown first. Absolute values for slope annotation Leading negative sign is removed from slope annotation Always return focus to Toolbox If selected cursor focus is removed from AutoCAD to CadTools (ToolBox) after picking lengths or annotation in the drawing. This can be useful if you plan to input values by keyboard frequently. If you plan to do something else immediately in the drawing after picking or annotation this checkbox should be off. This setting only works in Slope mode Scale factor when picking length with scale Using CadTools with profiles with different horizontal or vertical scale this factor is multiplied to picked length. Leading/Ending Characters Calculated responses are formatted after this setting. Useful for percent sign etc. Decimals Calculated strings ready for annotation are rounded according these settings. Annotation Color Annotations is always placed at current layer, colors applies this setting Text Height Text height for annotated values
Note!
Some commands use text height and other settings from this form.
Settings
10
Convert commands
Convert <Commands>, <Convert> Arcs > 3D Polylines
Replaces Arcs with 3Dpolyline segments. The segment length is calculated using Chord Height settings (settings form)
11
EPANET commands
Create EPANET Inp-file from DWG <Commands>, <EPANET>
This command creates an EPANET input file that can be imported to EPANET. There are three types of lines that are supported by this command, Polylines, 3D-polylines and lines. ID:s for pipes and junctions are created by CadTools. Pipes within the snap tolerance are merged to nearest junction.
12
Commands
13
Text commands
<Commands>, <Text> Align text to UCS and scale it.
Selects all single line text or multiline text and align it to current UCS.
Text capitalize
All selected text in the drawing is capitalized.
Text uncapitalize
You will get two questions, the first is "Make first letter capital?" Answering Yes on this makes the first letter in the text uncapitalized. Answering No will result in another question "Make first letter of word capital?" Answering Yes on this makes every first letter in every word capitalized. Answering No has No effect on the text.
14
Commands
15
Block commands
Block attribute to text <Commands>, <Block>
This command converts all attributes for a selected block to plain text. First you pick a point in the drawing where the text will placed then you select the block. You can only use this command for a single block, selections of several blocks is not supported. In the Image below you see the attribute as green text and the extracted text as white.
Tip! If You dont have manholes as block you must create these. Make the block with an attribute (ID). Insert the block at all manhole positions. Use the CadTools command "Edit block attribute text" to make a counter for all attributes (ID) If the manhole elevation is in a single line text you can use the command earlier to fetch the text to another attribute in the same block
16
Commands
In the first section you select a block (manhole), use the button "Pick" and select a block in the drawing. CadTools lists all attributes in the block in two DropDowns. Select attribute for identification (ID) and if you have a attribute with elevation you can select it as an optional attribute. Elevation value will not be processed just passed to the Excel-file as it is so you can use it for other purposes. Blocks that not contain the tag for Identification value will be ignored (filtered out). You can process much different kind of blocks at the same time, the only demand is that they must have the specific attribute that you selected. The name of the block is not important, the tag is. Tip! If your block doesn't have a tag for elevation, then make one. If the elevation of the block itself is the correct one you can use other commands in CadTools to annotate block elevations to the drawing and then use the CadTools command "Block Attribute Text Edit" to fill the attribute with the annotated elevation. Using the optional attribute as an elevation will make it easy to calculate slopes in the resulting Excel file.
Next section describes the maximum distance from the lines end or start point to nearest block (picture 2, value A). If possible block is at a longer distance it will be excluded. You can change color for lines and attributes that have been found and used, this may help if something seems to strange. A very high value can give the result that a block is reported in many places, the software always calculate the nearest block. The third section is used for pipe dimensions. You can set up a maximum perpendicular length for the text (picture 2, value C). To prevent text that is closer to the line but also closer to the endpoints you set a percentage value of the total line length (picture 2, value B). If the total length of the line is 100 units the value 10% will make text at a range of 10-90 units inside the line possible (the point where the perpendicular line from the text insertion point to the line must be at the range 10-90% of total line length) You can exclude polylines based on vertices, this might help to filter other lines than pipes. You can change the color for text that has been found and used
17
Picture 2 After you pressed Execute, use a crossing to select all objects. Unwanted objects will be filtered out. CadTools calculates the most likely solution for all blocks (nearest block relative endpoints) and then starts Excel with the results. The resulting Excel Worksheet contains columns with values. Attribute 1 and 2 are blocks with attribute tags according to your settings, the line text is the text along the line and theoretical distance (shortest) between the blocks.
After you figured out how this function works it's easy to use it in many other ways.
18
Commands
Adding a counter to a block attribute This is a handy command if the block are manholes and you want to add a unique id to an ID-tag. If you planning to use "Drainage Network Evaluation" this command can help you to insert elevation. The elevation option is developed for situations when the elevation is placed in a attribute value. Beware! Don't add or remove any text to same attribute that contains elevation when using "Set Block elevation to selected block attribute value", that will result in wrong elevation. The counter is inserted in the same order as the block was selected.
19
Before
After
20
Commands
Inserting text within distance to block attribute Use this command to insert text to attributes within a distance from blocks. You can change settings so that blocks that found a text change color. You can also prevent text to be inserted multiple times (in more than one block). Furthermore you can move used text to current layer and exclude text outside a given range. CadTools evaluates all blocks and text to find the closest text to every block. The "Block Attribute Text Edit" function can be used in many ways to manipulate attribute values with coordinate based text. You could combine this with other functions in CadTools to accomplish what you need. I.e. Exporting block values to Excel, manipulating them with formulas and then paste them back to the drawing with CadTools "Draw from Coordinates". Then using this function to insert the value in a attribute. Before
After
21
Draw commands
Mtext with leader <Commands>, <Draw>
This is a easy way to insert text with leaders to the drawing. Input sequence as below 1. 2. 3. 4. 5. 6. Input insertion point for the annotation (MText). Type of arrow Number of lines Text for line 1, confirm text input with enter Text for line 2.....etc Point for leader arrow
22
Commands
Six types of features can be plotted to the drawing, all types are described with images of input and result below. 1. 2. 3. 4. 5. 6. Polylines, point to point Polyline vertex Circle at point Block at point Text at point Block at station/offset from polyline
23
Polyline vertex
Creates one polyline from the vertices in the list
Circle at point
Creates circles from the vertices in the list
24
Commands
Block at point
Creates blocks at points in list. Blocks insertion point is used. When the form is loaded all block information is red from the active drawing, if you change drawing the information block information needs to be updated. You can do this by placing the mouse pointer in the block list and press CTRL + R, all block names from current drawing will then be accessible from the list. A quicker method to get a block name is to use the pointer button to the right of the block list and then pick a block in the drawing.
25
Text at point
26
Commands
27
28
Commands
Layer commands
Layer commands <Commands>, <Layer>
Layer commands commonly used to speed up work. These commands can also be found in the topmost toolbar
All layers on
Turns all layers in drawing on.
Delete layer
Deletes selected layer, included entities will also be deleted.
29
Line commands
Area Calculation <Commands>, <Lines>
This function calculates Polyline areas based on user selections. Area annotation is placed at the first vertex of each polyline. If Annotate Total Area is checked CadTools ask user to pick annotation point in for total in the drawing. After calculation the results can be exported to Excel (message box asking user). Closed status of calculated lines are in third column. You can filter polylines based on display color and layers, i.e. only calculate yellow lines on a specified layer. There is a better command for cross-section Cut and Fill areas, please follow link: Cross section area
Tip! When calculating areas in cross-sections, use Autocad's BPoly to create closed polylines of areas. To create end area volumes you can export all values to Excel and create your own formula.
30
Commands
Clear the table Select a new basepoint Change base-point elevation (if different)
How to annotate a set of polylines and some extra points 1. 2. 3. 4. 5. 6. Select basepoint in the cross-section (any point on cross-section centerline that can be identified with a elevation) Type in basepoint elevation Be sure to use correct exaggerations Select polylines in the drawing (use crossing or pick one by one) If you want you can add extra points of interest to the table by pressing "Add point to table" If desired, paste table in the drawing by pressing "Paste Table"
31
32
Commands
1. 2. 3.
First you need a 3D polyline that describes the alignment in plan. If it's a road alignment the easiest way to do this is to create a smooth line by using Autocads "Draw Polyline". Convert the polyline to a 3D polyline with CadTools "Convert command" Now you have two options, load a surface and drape the line to get a surface profile or use CadTools "Surface profile". If you decide to go for the first option you drape the line and then use "Profile 3D polyline" on the draped line, the second option "Surface profile" has some similarities but instead of profiling the line you use it as reference line. Plot the profile in current drawing near the plan line. Now you have a 3D polyline describing the alignment in plan and a profile of the terrain beneath it. Once again using Autocads "Draw polyline" you create a smoth profile line in the plotted profile frame. If you used a vertical scale in the frame CadTools will take care of that. When you are satisfied whit the line, convert it to a 3D polyline. Now we need to merge elevation data from the profile to the plan line. Do this by using the "Create 3D alignment" in the menu of the "Profile 3D polyline" form. Follow the instructions on the command line. (select frame, horizontal line, vertical line)
4. 5. 6. 7. 8. 9.
Note! When converting arcs in both ordinary arcs and arcs in polylines, CadTools inserts vertices (replacing arcs with straight elements). You can change setting for chord height in the "Settings form" However the accuracy of the result may not be suitable for certain conditions. You should also consider the possibilities of "bad" angles between elements. It's up to the user to decide if this method is appropriate or not.
33
1. First a 2D polyline is drawn in the plan (red line). When satisfied the line is converted to a 3D polyline.
2. The 3D polyline is used as reference line in the "Surface profile" command. (you can also use "Profile 3D polyline")
3. Draw a new profile line for the alignment as a 2D polyline (white line in the profile frame).
4. Using the "Create 3D alignment" command the resulting 3D alignment shows up as a thick white line.
Sample of resuming work. A. Continue with offset 3D polyline to create shoulders. Create longitudinal features and tickmarks. B. Result is real 3D!
Triangulate longitudinal features to a design surface. Edit the triangulated result (delete unwanted triangles) and save it with "Edit surface"). Calculate cut and fill volumes. Annotate centerline and shoulder elevations (transverse features), ditch bottom slope arrows.
34
Commands
Create cross-sections of existing ground, design and other surfaces with "Surface cross-section"
Tip! You can replace step 6 by marking the "Paste result after calculation" this option has same effect as if you press the "Paste Result" button. When calculating closed polygon areas the polygon must not cross itself. If so the area will be wrong.
35
Image of result in drawing. Note that this drawing also has been processed with the "Annotate Cross-section command"
Note! The Cut&Fill calculation is based on some simple rules, lines must not have "loops" and the proposed line may not exceed the existing line. "Loops" are reversed portions of the line, all offset values must be descending or ascending. The line can't change direction in any part, if so CadTools will inform the user. Image below shows a unsupported line
36
Commands
Excel output
Tip! If your drawing has polylines with arcs you may save it as a copy and explode all lines. Then run CadTools LineCalculation to extract radius.
37
4. Snap first and last points of the converted arc to line ends
5. Use CadTools "Level out 3D polyline" on the converted arc to get a smooth transition between the lines. Tip! The "level out" command works with multiple selections. You can put all arcs on a unique layer and turn off all layer but that before using "level out". Do this before picture 5 and then select all in the drawing.
38
Commands
39
40
Commands
Best fit
Use this command to replace a 3D-polyline with a linear regression of all vertices (X,Y and Z). This is done in the same manner as you would do in a Excel chart when creating a Trend-line. The result is a straight line with two vertices. The linear regression algorithm uses the X (eastings) to adjust the Y (northings). Tip! If you want to use this method on points you can export the points to Excel with CadTools point command (Export to Excel) an then draw a line with the "Draw" command. It the polyline is a 2D-polyline, convert it to 3D-polyline using CadTools Convert command and then use this command.
Simplify 3D-polyline
This command uses the Douglas-Peucker algorithm to reduce vertices in a 3D polyline. The Douglas-Peucker (DP) algorithm uses the closeness of a vertex to an edge segment. This algorithm works from the top down by starting with a crude initial guess at a simplified polyline, namely the single edge joining the first and last vertices of the polyline. Then the remaining vertices are tested for closeness to that edge. If there are vertices further than a specified tolerance, > 0, away from the edge, then the vertex furthest from it is added the simplification. This creates a new guess for the simplified polyline. Using recursion, this process continues for each edge of the current guess until all vertices of the original polyline are within tolerance of the simplification. More specifically, in the Douglas-Peucker algorithm, the two extreme endpoints of a polyline are connected with a straight line as the initial rough approximation of the polyline. Then, how well it approximates the whole polyline is determined by computing the distances from all intermediate polyline vertices to that (finite) line segment. If all these distances are less than the specified tolerance , then the approximation is good, the endpoints are retained, and the other vertices are eliminated. However, if any of these distances exceeds the tolerance, then the approximation is not good enough. In this case, we choose the point that is furthest away as a new vertex subdividing the original polyline into two (shorter) polylines, as illustrated in the following diagram.
41
This procedure is repeated recursively on these two shorter polylines. If at any time, all of the intermediate distances are less than the threshold (tolerance), then all the intermediate points are eliminated. The routine continues until all possible points have been eliminated. Successive stages of this process are shown in the following example.
42
Commands
Result in drawing
43
Slope and Road signs 2D (topic for road signs and markings) <Commands>, <Lines>
Its easy to draw road markings and signs with CadTools. Pedestrian crossings, bicycle paths, give-way and chevrons will be described in this section. Surely there are more types of lines and signs that can be drawn with CadTools Slope mark function. The Slope sign command was one of the first commands in CadTools. This was a powerful function from the beginning. By extending it with the possibility to draw other than perpendicular lines it now can be helpful when constructing Road markings. You can prepare your own settings for different drawing types of tasks. Use the menu "Settings" on this form to load the user settings form. You also have the option to create road marks as closed hatched Polylines. Creating signs as Polyline gives a better result than using solid lines. Many design manuals for road signs describes width and space between road signs. Mark the checkbox "Keep interval as free space" to obtain same space between signs as in input interval. If you tilt signs by providing an angle, CadTools always plots the Polyline correct width. One benefit of using ordinary Polylines is that they easily can be edited in AutoCad. Other software might do this more user-friendly by calculating drawing scale and filling arrows but it can't be edited unless you have the software that created them. The typical flow of creating road signs with CadTools is: 1. Create supporting 2D polylines by offsetting design lines with Autocad's offset. As an alternative you could convert 3D lines to 2D with CadTools "Convert" command. 2. Set up your desired input values in Cadtools, press Execute 3. Pick top line (first line) 4. Pick bottom line (second line) 5. Erase or hide supporting lines
Important! If you have set hatched properties and the result is empty polygons, try to change hatch scale. (Use appropriate decimal separator! Same as your operating system) You can not save intersections to tempfile when using the "Draw as Polylines" command. Remember to set max length when creating markings for shoulders and other thin lines, otherwise there might be unwanted lines. The possibility to change angle in SlopeMarks is only available for registered users! Tip!
You can use this command to create parking lot markings. Set interval to the parking space for one car, set Minor tick size to 100%. Draw two parallel lines for the front and the back of the parking space. Run the command! Consider the opportunity to set an angle here, that would also create another type of parking lot. Use CadTools command "Area calculation" to get road sign areas to Excel You can also export Hatc areas to Excel, look at Hatch Commands
44
Commands
Save commonly used type of markings (settings) You build your own library of settings for any type of markings or what ever. In the left bottom there is a drop down list with all your saved settings. Selecting any of these settings will change all input values in the form. Edit or add new settings by using the menu "Settings" in the form. You can share your settings to others by copying the file "Cadtoolssettings.uds" that's located in same directory as CadTools executable file. Pasting (overwriting) the file to same location at another computer gives that user same saved settings for booth "Cordinate grid" and slope (road markings)
Samples Images below shows settings and result for some types of common markings, depending on country the settings might be different.
45
Chevrons
First you draw a couple of Polylines (reference line in the middle and two lines for the traffic). Draw Slope marks from the centerline towards the outer lines, toggle the negative sign of in the angle before executing the second line. Now change the global width of the two outer lines in Autocad and it beginning to look familiar. The arrow can be done in same way, draw a Polyline and change start width in Autocad. Steps to create Chevron
46
Commands
Pedestrian crossings
Draw a Polyline and use AutoCads offset to offset the line to desired width of the crossing. Set Start and End Width in cadTools, draw slope marks between the lines. Steps to create Pedestrian crossings
47
Bicycle paths
Draw a Polyline and use AutoCads offset the line. Set Start and End Width in cadTools, draw slope marks between the lines. Steps to create Bicycle paths
48
Commands
Same text can be used as elevation for more than one line, you can prevent bad elevations by setting the max value to a small value.
This command is extremely time-consuming 100 text and 100 lines gives 10 000 solutions to process. You should always use this command with a backup copy of the original drawing. After completion lines can be triangulated with CadTools "Create Surface" command.
Max-value What if the max value is set to high? Well, think of the value as a seek perimeter to the line. I huge value can get bad results
Color for successful lines Polylines and text that gets elevation from text can be colored.
Move successful lines to layer Polylines and text that gets elevation from text can be moved to a layer. Use layers in the drawing or type in a new layer. Using Ctrl + R in the layer dropdown refreshes layer information.
Add result lines to layer Draws a line between line and the text that was used to set elevation. This is useful when looking for errors, you should place the result lines on a different layer than the lines.
49
Sample of result below, green objects was successful. If you look closer you can see the white result lines between the text and the line.
50
Commands
Set interval for lines between polylines. Max length is useful when intersections are found at not desired points. Minor Tick Size adjust every second line length, a value of 50 results in half distance. Start and End Width can be used to create slope lines shaped like triangles. Layer for the slope lines Color for slope lines Angle for slope lines Tick-marks in reverse direction (draws tick-marks from Toe to Top)
51
TIP! You can use this command to find the centerline between two irregular polylines. Sometimes its a good supplement to AutoCads Hatch command. If the checkbox "Save intersections to tmp-file" is marked CadTools writes all intersection coordinates to a file in the application directory. The name of the file is "SlopemarkTemp.txt" if there is a previous file it will be overwritten. Manipulate this file with Excel and use the command "Draw from coordinates" to plot a Polyline between the minor ticks. TIP! As you know CadTools uses the first picked line (Top) as reference line to create tick-marks. In fill conditions you pick the shoulder line first and the tick-marks will be created towards the terrain. In cut conditions there might be some problems, picking the terrain line first will generate correct but not so nice result. To fix this you should use the Tick-marks in reverse direction option (draws tick-marks from Toe to Top). This feature is not accessible when Plot as closed polylines is enabled.
52
Commands
53
54
Commands
Annotating elevation at given interval of a road or ditch. Annotating horizontal distance at given interval of a road. Annotating superelevation (%) at given interval to check if all is as it should be. Prepare data for triangulation, minor lines that will be triangulated can make the triangulated surface more accurate. You want to draw a parallel line between two 3D polylines, for this you must set then intervall to small value andset minor to 50%. Then us the "Save intersection to tmp-file" option and then paste the minor coordinates back to CadTools and draw a new polyline (vertex) Use "Save to tempfile" for grabbing the data and use it Excel or paste back portions to CadTools "Draw from Coordinates" command.
Tip! When creating transverse features (tick marks) for fore slope in cut sections, pick the ditch bottom line nearest the polyline first. When creating the back slope features pick second ditch bottom line first. For the fill sections pick main line first. Doing this gives neat transverse features at exact same station. If working with pads there might be problems with uncontrolled tickmark crossings, set max length to avoid this behavior.
55
This form is built in three parts. Upper part The upper part has input fields for horizontal interval, max length and minor tick size. Max length is used to prevent creating unwanted tick marks, if set to 10 no tick marks will be created if length is above 10. If minor tick size is set to 100% the minor line is full length between polylines. Notice! Normally the "Use first..." should be on! It's important for the behaviour of all tickmarks. If on, the decision of where minor ticks should start (based on elevation) is handed over to CadTools, the result is always correct. This is a very important setting, therefore the setting always is on as default. If this option is unmarked minor tickmarks start point is drawn from the first selected line, the real slope direction is not evaluated. This might result in wrong directions, its up to the user to decide.
By using this option you are guarantied that minor tickmarks are created correct. (based on elevation of perpendicular start and end elevation). Minor tick marks starts at the polyline with highest elevation
56
Commands
Middle part The middle part of the form has settings for annotations. This is useful for annotating transverse slope or annotating reference/target line elevation at given interval.
Ditch bottom elevations at given interval Centerlines elevations at given interval Backbones elevations at given interval
In image below transverse slope is annotated, no transverse lines are drawn. Could be used to check super elevations.
57
Bottom part Here you set layer for annotations and features, useobject picker button to get layer from any object in the drawing. Another handy thing is that you can save all calculated intersections to a temp-file. This file can be opened with Excel (as textfile, CSV-file) and imported to Excel directly. Do your own calculations in Excel and then paste the result back to CadTools with the "Draw from coordinates".
Miscellaneous commands
<Commands>, <Miscellaneous> Dist with Slope
If you want to know horizontal length between two 3D objects in the drawing this command can be helpful. Certainly you can use Autocad's "Dist" command but if snap is on you may end up with only real length. With this command you can use the snap option in Autocad and easily get horizontal length, real length, start- and stop elevation and slope.
3DSolid to Excel
Send 3DSolid volume to Excel
Region to Excel
Send region area to Excel
58
Commands
Point/Circles commands
59
Mode commands
Command Tree <Mode>, <Command Tree>
This mode provides access to all commands of CadTools without using ordinary menus. Using this mode can speed up your work, every command can be executed with one click. Compared to navigating along windy menu paths this is much easier. Use the right button to expand or collapse all tree nodes.
60
Commands
Buttons from Left to right (second row) 1. 2. 3. Pick length from active AutoCAD drawing. Annotate selected response to active AutoCAD drawing. Output string is formatted according to user settings. Toggle Z on/off. When picking lengths from drawing this setting will prevent (if off) the software from applying Zcoordinates to the input box. This is important if you want to input heights by yourself. Working with drawings made in 2D where the heights is presented by text is one of the occasions you want have this toggle off. Calculate. CadTools calculate selected response and formats the output string according to user settings. Pick length and annotate in one command. Pick scaled length. Length is scaled based on user settings. Pick scaled length and annotate in one command. Toggles line on/off. Draw a line between picked points. Draw arrow in slope direction (if on in user settings)
4. 5. 6. 7. 8.
How it works CadTools always calculate all values to get balance. You can change response and then press enter for a new calculation. By doing this a new response value is in memory ready for annotation. Plans If you have a center-line with heights in a plan and wants to calculate a height near the curb. First of all toggle Z-coordinates off. Select response EndHeight by clicking the radio-button below. Input desired Slope (in Percent). Click button 1 (pick length). Snap to centerline where the height is. Snap to curb near where you want the calculated height. Click on button 2 (Annotate) and select position for annotation text. Cross-sections Working in cross-sections you can set slope to 100% and toggle z-coordinates of. Input height from nearest legend in the StartHeight box. Select EndHeight as your response and pick length by pressing button 1. Now snap start point to the legend with perpendicular in AutoCAD and endpoint to desired point in the cross-section. Annotate the calculated height in the drawing. Profiles Working with drawings that have different vertical and horizontal scales must be treated different according to picked lengths. Therefore the user can set a scale factor for picked lengths. Using button 6 will scale the lengths before calculation. The Status Bar at bottom in the software gives you information about original and scaled length.
61
1. 2. 3. 4. 5. 6. 7. 8.
Set current layer by object. Move to layer by object. Layer off by object All layer off but selected All layer off but current All layers on Layer freeze by single objects (xref). Delete Layer
1. 2. 3. 4.
MText with leader Create coordinate grid Draw revision cloud Draw from coordinates (paste from Excel)
1.
1. 2. 3.
62
Commands
4. 5. 6.
1. 2. 3. 4. 5.
Make Xref relative path (current drawing) Open Xref by object Detach Xref by object Save Xref settings to file Load Xref settings from file
1.
Polylines to INP-file
1. 2. 3. 4. 5. 6. 7. 8.
Aling text to UCS and scale it Left align text Insert trailing/ending character to single line text Insert line-aligned text Remove trailing/ending character from single line text Export to Excel Capitalize single line text Uncapitalize single line text
1. 2. 3. 4. 5.
Block attribute to text Edit block attribute text Match block with lines Annotate block elevation Export block coordinates to Excel
Fourth row 1. 2. 3. 4. 5. 6. 7. 8. 9. Area calculation Annotate polyline elevation Create 3D alignment Densify 3D polyline Export polyline to Excel Join 3D polylines Polyline length calculation Level out 3D polylines Create solids from 3D polylines
10. Multiple 3D polyline offset 11. Offset 3D polyline 12. Reverse polyline direction 13. Track station and offset from 3D polyline
63
Fifth row 1. 2. 3. 4. 5. 6. 7. 8. 9. Profile 3D polyline Set 2D polyline by nearest text Draw slope arrows on 3D polylines 3D polyline stationing Table edit 3D polyline 3D polyline regression (best fit) Remove duplicate vertex from 3D polyline Simplify 3D polyline (weed) Slope and road signs (2D)
10. Transverse lines between 3D polylines Buttons, sixth row to the left (Point/Circle tools)
1. 2. 3. 4.
Annotate point/circle elevation Annotate single point Send point to Clipboard Export point/circle to Excel
1. 2. 3. 4. 5. 6. 7. 8. 9.
Create surface Edit/View surface Create longitudinal features (cut and fill) Create surface contours Create surface cross-sections Create surface profile View surface slope and direction Surface volume Surface volume by elevation
64
Commands
Surface commands
Create Longitudinal Features <Commands>, <Surface>
This command generates longitudinal 3D Polylines between 3D Polylines and a surface or elevation. The surface must be triangulated by CadTools and saved to file before using this command. If you plan to intercept an elevation no surface is needed, otherwise a surface must be loaded. To load a surface, use the menu Load Surface. Change parameters for Cut, Fill and Ditch bottom to preferred values. All slopes should be input as -0.25% or as -1:4. If you use type"1:4" CadTools convert the expression to slope percent when you move focus to another textbox or button.
Preview you current settings and typical result with the preview window. This window floats and updates when settings are changed.
To draw transverse features (slope signs, tickmarks) automatically after creating longitudinal features select the Tick Marks checkbox. If you want to do it later, use Transverse 3D lines between 3D Polylines. This command is located in the top menu and in CadTools main form under lines. Remember to check the option "Use first line as..", its a smart choice. Image to left showing longitudinal features created with "Tick marks" unchecked. Image to right showing tick marks created in one commands.
65
How it works At every station based on the density value CadTools evaluates the cut section. If no solution is found it then evaluates the fill section. If booth cut and fill fails no feature will be created for that station (gap in the line) Density interval sets stationing for the calculation, a small value increases accuracy but slows down the process. This value should not be bigger then 0,5 to get any useful results. If you got plenty of time a smaller value results in more accurate result. After processing check transitions between cut and fill by using the orbit command in Autocad. Rotate the model to revel any bad transitions. If working with pads there might be problems with uncontrolled tickmark crossings, set max length to avoid this behavior. If cut foreslope distance is set to 0 (zero) no features for the first cut line is created, if ditch bottom is set to 0 (zero) no feature for second ditch line is created. Tip! When manually creating transverse features (tick marks) for fore slope in cut sections, pick the ditch bottom line nearest the polyline first. When creating the back slope features pick second ditch bottom line first. For the fill sections pick main line first. Doing this gives neat transverse features at exact same station. Destination layers and colors for output are selected from drop-down list, to get newly added layers into list use "ctrl + R" to refresh list. If you type in a layer that doesn't exist, CadTools creates that layer in current drawing. Use the "Hair-Cross" buttons to pick layers in the drawing to the drop-down list. Remove loops Removes the loops that may appear at concave corners. This option allows the longitudinal feature to more accurately represent the original feature. If loops are stacked or to complex CadTools can have problems to solve them completely, some manual work in the drawing might bee needed. The first example image below shows a longitudinal feature that was generated with this option turned off. The second image was generated with this option turned on.
Simplify output (weed) This option reduce vertices in all output lines ( tickmarks excluded). Only vertices on straight parts of lines are processed (simplified), the accuracy of processed lines are same as before. The behavior is same as using the polyline tool with tolerance set to 0 (zero) You can get same result by using the simplify command after all lines are sent to the drawing. For information on simplify Command, follow link: Simplify polyline Speeding up the process If you find this command to slow there is at least one thing you can do to speed up the process. As you probably know, computers are stupid but quick. To calculate interception between a line and a plane (triangle) all triangles in a surface must be evaluated. If the surface is big and you plan to work on a small area its smarter to create a smaller surface around the design area. Use the Edit surface command to delete triangles outside the desired area. Related topics: Triangulate, Edit surface Advanced use Use offset 3D polyline or Multi Offset to create references lines for more complicated structures. Use this command to finally generate longitudinal features for end conditions. Triangulate all longitudinal lines with constrained triangulation to create a design surface. That design surface can be plotted with the existing surface as cross-sections or profiles. You can also create surfaces for other types (rock, foundations) You could think of this like a method to create end conditions, if you are heading for more complex structures you can use "Offset 3D polyline" to build your lines before using this command. It's possible to build a set of 3D polylines and finally create intersections with surface, triangulate the 3D polylines as constrained triangulation and end up with a real 3D model.
66
Commands
Tip! Think of this function as a laser beam that is pointed perpendicular from a 3D polyline. By setting slope and some other values to 0 (zero) you can accomplish many cool things, like horizontal projecting a 3Dline to a raised road or any other surface.
67
Plot triangles
This command plots all triangles to drawing. Select output style, 3DFaces or 3DPolylines. This is the same command that can be used when triangulating a surface. There is no need for plotting triangles unless you planning to edit and save them. All commands works with the surface loaded in memory. (plotting triangles to Autocad is a slow process)
Plot perimeter
This command plots boundaries of the surface. If there are holes in the surface these will be treated as boundaries. You can filter the plot to only include triangles within a given range of slope. The result of this might be a set of isolated perimeters, you can also set a minimum horizontal area to be displayd. This is handy for i.e. identifying flat areas larger than a given area. As an option you can plot boundaries for areas with specified slope, you can omit small areas
68
Commands
Image showing resulting perimeters where red areas has slope between 0% and 0,5 %, areas smaller than 10 are omitted.
69
Tools
Trickle
This command traces the path of a drop of water down a selected surface. Note! The path ends when all surrounding triangles forms a pond no matter the size of the pond or when the path reach the surface boundary. When the path gets to the border of the surface, it stops even if the outer most triangle has a slope that would allow the drop to follow the rim of the surface.
Trickle All
This command does exactly the same as above but for a complete surface in one command. A drop of water falls on every triangle center and then CadTools calculates the path towards the lowest point. When all triangles has been evaluated CadTools sums all involved triangles planar area and annotates the area to every corresponding pond. Elevations of annotations are set to same as surface and can easily be exported to Excel with CadTools command:Text, Export to Excel. The Trickle All command can be useful in the designing process of pipe dimensions.
70
Commands
71
Miscellaneous Use Annotate triangle number to get the triangle number at triangle center. CadTools surface files are stored as plain text files with triangle vertices coordinates. If you want to track data from volume calculations or other commands this might be helpful. The "Triangle volume" command uses a different approach for more exact volume calculations. That process creates "memory triangles" based on the projected features. You have the option to create a tmp file in the volume command, if you annotate the design surface the data in the tmp-file will not be the same due the method of using memory triangles. To overcome this you can past the triangle center coordinates and the triangle number from the tmp-file to CadTools "Draw from coordinates" to get a correct annotation of the memory triangles. If you want to display memory triangles in the drawing you can use the option to annotate Cut/Fill in the volume command.
72
Commands
3. Intersections of the line and remaining points on each side are triangulated
During the process you might get some messages about problems with the triangulation process, often when triangulating dense data I.e. design models. It's a god idea to continue anyway and examine the result. Its rather easy to delete or correct triangles using Autocad's Shade command (and Orbit) Tip!
73
If you have problems triangulating long parallel polyline structures, try to explode them to lines and triangulate segements or triangulate a couple of lines at time. You can always save plotted triangles from drawing to same surface file using "File, Save triangles to file". Another tool to use if problems with triangulated result is "Densify 3D polyline" Image below showing triangulated design model that's been corrected (triangles outside cut and fill lines has been deleted)
Steps to triangulate 1. Select types of input data by checking appropriate check boxes. Press "Select objects" button. And select objects for triangulation. Only checked object types will be used by CadTools so you can select by crossing. 2. Set maximum triangle side, omit if not relevant. 3. Select triangle output, to file or drawing and as 3D faces or polylines. Press triangulate.
74
Commands
75
Estimated option
For the estimated option elevation of design triangle vertices and the triangle centre point are compared with the same spot at the existing surface. If the existing surface is flat this option gives a pretty good accuracy. If the surface has ridges and valleys the volume might be wrong, imagine that a ridge or valley in the existing surface lies between two or more points of the design surface. Note! Only triangle points are evaluated. Having a normal Original surface with rather small triangles and a Design surface with huge triangles will result in incorrect volumes
Report
The "Report" button opens a text-file with the most recent volume calculation. The header of the file contains same information as the result from the volume calculation. If you want to track data from volume calculations the bottom part of the file might be helpful. Using the Tool "Annotate triangle center" located in the "Edit/View Surface, Tools, Miscellaneous" dialog to annotate triangle numbers and compare it with the report-file unique triangles can be located. The "Almost Exact Triangle volume" command uses a different approach for more exact volume calculations. That process creates "memory triangles" based on the projected features. If you annotate the design surface the data in the tmp-file will not be the same due the method of using memory triangles. To overcome this you can past the triangle center coordinates and the triangle number from the report-file to CadTools "Draw from coordinates" to get a correct annotation of the memory triangles. If you want to display memory triangles in the drawing you can use the option to annotate Cut/Fill in the volume command.
76
Commands
Tip! Paste the content from Notepad to Excel to get a nice report
77
78
Commands
Profiled model
In this topic a method to create profiled model are described. The profiled model is an alternative method to visualize the relief in a digital terrain model. The method is to create a set of lines that are draped onto the surface using the "Surface cross sections" command. If you load additional surfaces (subsurfaces) you will end up with several profiled models. You can also drag a surface file from Windows Explorer onto CadTools surface list to load the surface.
1. Plot outer boundary for the actual surface using "Edit/View Surface"
Start "Surface Cross-Section"command from the Surface menu. 1. 2. 3. Set Left and Right offset same as Ref. line length to get cross-section lines that covers the entire surface. Select the 3D-line as reference line and set interval same as desired grid size. Select "All Stations as 3D-sections" and press Execute.
79
Now you should have lines projected onto the surface in one direction.
Draw a new perpendicular 3D polyline, select as reference line and change left and right offset wider than the maximum with of the surface in the perpendicular direction.
80
Commands
Interval controls the difference in elevation between each major contour line. For example, you can display major contour lines at 1meter intervals. The Interval must be greater than zero (0). Minors per Major Defines the number of minor contours that display between neighboring major contours. For example, if you set this interval to 4, there are four minor contour lines between each major contour line. Usually, this value is set to 4 or 9. If you use a zero value, no minor contours are displayed. Single contour Use this for contouring a single elevation. The contour and annotation properties are set same as for major Contours. Annotations Annotations text color and layer can be set for booth major and minor. To omit minor or major annotations you can set Textheight to 0 (zero) Random factor The random factor is used to manage population of annotations. The contour algorithm evaluates every possible contour for each surface triangle step by step. For that reason the contours will contain line segments representing the triangle intersection with the plane (current elevation).For every contour line segment that's generated the software checks if a randomize value from 1 to the random factor is equal with 1. If so the annotation will be plotted between that segments start and endpoint. Setting Random factor to 1 will result in annotations at every contour segment, increasing the value decreases the number of annotations.
81
No Automatic Annotations This option omits all annotations. You can set text height to zero for both major and minor to get same result but then you have to set them back if you want to annotate by fence. If you planning to annotate by fence it's smarter to use this option to turn all annotations off.
Annotate by Fence
This command annotates contours by a fence line from the user. Click on the command in the menu and point out a start point for fence line in the drawing. Position endpoint so that the line cross one or several contours. The software annotates all crossing points whit elevation annotations based on the settings.(color, text height). To make the process faster the Annotate command sustains until the user hits ESC key. You don't need to load a surface for this command all data needed is stored in the drawing. Note! Only contours generated by CadTools can be annotated by this command.
82
Commands
Display references
83
Display crossing 3D lines in the cross- section by using the "Display References" menu. All lines will have Magenta as color in the preview window, reference lines will placed on same layer as the original line when plotted to DWG-file. You can display reference lines either as true lines with elevation from the line or without elevation. Using the option "Add display reference line with elevation" results in a filled circle at the position where the line intersect the section. Using the"Add display reference line (no elevation)" results in a dotted vertical line indicating the horizontal position of the reference line. The height of the cross- section will be adjusted so that all display references with elevation will be displayed. Plotting to DWG works in same way, cross section height will be adjusted. Use the "Output settings" menu for more options in DWG-file. To remove display references use the "Unload all display references"
Result can be plotted as ordinary cross-sections or as true 3Dsections. The latter option is useful if you want to create profiled surface models, read more about "Profiled model".
84
Commands
Image below shows a surface of existing ground as major surface and a design surface as subsurface, left offset is -29, right offset is 32. In this cross-section two 3D-polylines from the DWG are used as display references, the yellow is from a layer "Building" and the magenta is from "Fence" layer. To get the layer leader you need to select the option vertical text with layer-name in the Output settings form.
85
Tip! If you experience odd behavior of the surface cross sections in the outer parts the explanation can be that there are unwanted triangles outside the desired perimeter. To get rid of these triangles you can use the two commands described in the "Edit Surface" part of this help file.
Display references
Two types of reference lines are supported, crossing lines and projected lines. Display crossing 3D lines in the profile by using the "Display References" menu. All lines will have Magenta as color in the preview window, reference lines will placed on same layer as the original line when plotted to DWG-file. You can display reference lines either as true lines with elevation from the line or without elevation. Using the option "Add crossing reference line with elevation" results in a filled circle at the position where the line intersects the profile. Using the"Add crossing reference line (no elevation)" results in a dotted vertical line indicating the horizontal position (station) of the crossing point with reference line. The height of the profile will be adjusted so that all display references with elevation will be displayed. Plotting to DWG works in same way, profile frame height will be adjusted. Use the "Output settings" menu for more options in DWG-file.
86
Commands
Projected lines are selected from the drawing and then computed an displayed in the preview window. Projected lines will be plotted to the DWG on same layer as in the drawing, the color is also based on the original layer. This command is very useful when you want to evaluate other parts of your model. To get elevation beside your alignment, offset the alignment and drape it to the surface and then use it as a projected line. If you need to display a ditch bottom in your profile you can use the "Display projected line". Projected lines should not have any loops, they need to be somewhat aligned with the alignment, the distance from the alignment has no limitations. All evaluated points are perpendicular from the alignment. To remove display references use the "Unload all references" Image below show different types of available graphic features
Major surface is the surface that was first loaded Subsurfaces are surfaces loaded after loading major surface Crossing line with elevation is reference-line with line elevation at crossing point with the alignment Crossing line with no elevation is reference-line with line no elevation at crossing point with the alignment. This will result in a vertical line at the crossing station Projected line is a line that is projected to the profile could be a ditch bottom or any other 3D polyline. (use offset and drape commands to get surface offsets of the alignment)
87
88
Commands
Surface Specifies the surface you want to use to display slope vectors. Surface must be a CadTools Surface, use Surface import for other surfaces (triangles). Surface import is located in "Edit/View Surface" Display Mode Determines how to define the locations where the software generates and displays slope vectors. You can specify that the vectors be located at triangle centers or in a grid pattern. Triangle Center automatically places slope vectors at the center of each triangle. Use this option with care when your surface contains a large number of triangles. If it does, it will be difficult to read each individual slope vector annotation. Grid Point places slope vectors in a grid-like pattern. You define the grid-cell size using the X-Interval and Y-Interval parameters. This parameter is active only when Grid Point is the active Display Mode.
89
Annotation Booth vector and slope can be annotated on different layer and with it's own color. If factor is set to 0 (zero) CadTools creates a static vector (equal length despite slope value). Setting the factor value to other values results in vectors with length based on slope value multiplied with the factor. Note, setting the value to 1 does not results in slope vectors with exact same length as the slope, however setting factor to other values than 0 will result in longer vectors for steep slope. If slope is 10% for one vector and 20% for another the steepest vector will be twice as long, every vector length is proportional to the slope. Advanced Use these settings for overriding color for "Flat Areas" or other intervals as you please. You can exclude small triangles by setting a value of minimum triangle area. This option is not available when Grid Point is the active Display Mode.
90
Commands
Xref commands
Open Xref by object <Commands>, <XRef>
Use this command to open or activate already open drawing that is attached to current drawing as an Xref. This command also works in paper space if your Mview is in model mode.
What is happening ACAD looks back one folder from the current drawing folder (..\ means back up one folder) ACAD looks forward into Det from the current drawing folder (.\ means start from the current folder, or simply leave this off and the current folder is assumed) ACAD backs up one folder to CAD, then goes forward into S\Det
P:\Proj\CAD\A\Det\xref.dwg
.\Det\xref.dwg or Det\xref.dwg
P:\Proj\CAD\S\Det\xref.dwg
..\S\Det\xref.dwg
You can open the saved file with Notepad and use it for documentation of the X-ref settings
91
Hatch commands
Export Hatch area to Excel
Select hatch objects in the drawing and export area to Excel. You can select by crossing, Hatch objects will be filtered. Note! Not all Hatch object has area, don't ask me why. If any Hatch with empty area is detected CadTools will give you a message. To locate empty hatch look at the tip in the bottom section.
Tip! You can easily annotate Hatch areas to the drawing by paste the values to "Draw from Coordinates" form. Use the "Text at Point" option and paste "Bounding box mid X" and "Bounding box mid Y" columns from the Excel sheet with the Hatch areas. Paste the area values in the "Text" column, fill the "Z" columns with Zeros by using right click in the top cell. Image below shows sample result from that function.
92
93
Other issues
In this picture the "Pick3D/2D" button is toggled to 2D, the start height 50,07 and end height is 50,01 are typed in and the distance is picked from the drawing. The resulting slope -1,168 is the slope between 50,07 and 50,01 with the picked length and is calculated by the software. If you press the "Annotate" button you can insert calculated slope direct into desired point in the drawing. If you in this moment change response by checking one of the other "Radiobuttons" that are placed under the response fields, you can easily calculate another response based on same relation. It could be the height of any point on the extended blue line if calculate slope is accurate. To accomplish that you simply click on the "Radiobutton" under "End Height" and picks a new start point at 50,07 and endpoint on desired point. Clicking "Annotate" inserts the end height in the drawing. By using this method you can very easy extend heights in a drawing. You can also check if rainwater will flow in desired directions and with enough slopes. Tip! Hitting ENTER at any time will execute a new calculation and a fresh response.
94
How to
Working with cross-sections and profiles Have you ever been left with a couple of cross-section that are complex and therefore need some extra height-annotations? With CadTools thats no big problem!
In this picture of a simple section we have the ground as the cyan line at the top. The green line is the line that represents the level 50. As you can see, the ground is above the 50 line. For that reason we can set the slope to 100% and then pick any point at the ground line as the start height and then pick the end height at a perpendicular point at the 50 line. Of course we have to check the "Radiobutton" under End Height because we are looking for the height. Beware! If the end height we are looking for is under our 50 line we must set slope to -100% By using AutoCADs OSNAP in a smart way this method can be very fast and accurate.
For profiles the method above will work if you have a drawing with same scale horizontal and vertical. If thats not the case you can set a scale under settings. This scale factor is used when you pick lengths with the scale button. Hovering over the button will show present scale factor in the statusbar of CadTools.
95
Known problems
Can't open saved surface or bad data Moving a surface file from one computer to another might end up with a file that can't be opened or contains bad data. Booth computers must use same decimal-separator! CadTools stores surface data in a plain text-file therefore it's easy to edit all surface data. Solution Open the surface file with notepad and check if the decimal separator is the same as on your computer. If not use the notepad command "Find and replace, all" to replace all incorrect decimal separator with the correct type.
96