- Zachary Carlson
Katapult Pro Pre-Design Manual
Updated: Apr 4
Pre-design is the first step of the Katapult Pro field collection process and is used to plot the route before fielders go out for collection. This step is typically conducted from the desktop (or a laptop in the field) and is used to make sure that the data collection process in the field stays safe and efficient, limiting field exposure as much as possible.
Having to complete design work from a mobile device during tough field conditions can take the wind out of a field crew's sails, so we highly recommend that your team take the time to prepare each design from the office to put your field crews in the best position to succeed.
Open Katapult Pro Maps and select “Create New Job." Enter the job’s name and models (if applicable), then select “Create Job.”
You will be able to zoom to a location using the magnifying glass icon. Just enter the address or nearest destination where you would like to start designing. Once you enter the location, click the magnifying glass. The map will pan to the nearest location you entered. Click “Done” to exit the zoom window.
The Different Ways to Pre-Design
There are multiple ways to predesign or scope out routes within Katapult Pro. The first pre-design method this documentation will cover will be to simply plot nodes directly onto the map using your mapping tools. The documentation will also cover using imported layers to bring in a file directly onto the map, as well as dragging KMZ, .shp, or .csv files directly onto the map.
Using your mapping toolsets on the right side of the page, you can open up the different toolsets full of mapping buttons to begin plotting or drawing directly onto the map. Check out our Model Editor Manual for more information on Map Buttons and Toolsets!
As your mouse hovers over each tool/button, the name of the button as well as a shortcut in parenthesis will be displayed to the left.
*Not all buttons will have shortcuts, but these, along with the buttons and toolsets, can be edited using the Model Editor. Please refer to the Model Editor documentation for further instruction on this.
When you click on a tool, you will see a menu pop up at the bottom middle of the page. The cursor of the mouse will turn into a shadowed out dropper. You can use this to place items onto the map. Just left click to place the item on the map. Using the aerial tool as an example, when you click on the map and place a pole, a connection will display after you make the first click.
You can either use the dropper to click on the next pole on the map or you can enter a set distance for the span. This will lock the connection to that distance so that you can then select the pole or location placement. You could also fill in a bearing to lock the angle as well.
Once you left click to add the second pole, the focus of the map shifts to the new pole. You can see a yellow highlight or halo around the location the drawing action will start from. Because the aerial tool was used, the connection_type attribute between the poles is automatically set to aerial. You can click on the connection at any time to change the type if needed. You can also hold a left click on the poles to move them. Releasing the click will set the position on the map.
When you are done using a specific mapping tool, you can switch to another tool using the new button shortcut or clicking the new tool within the toolset on the right side of the page.
You can also cancel out any selected drawing tool by hitting Escape on the keyboard, clicking the “X” within the window at the bottom, or right clicking on your mouse.
If you click on a location such as a pole, you will see three icons located under the item. The trashcan icon will delete that location, the multi directional icon will move the item, and the pencil icon will open the node info panel for editing.
If you have your map labels set to have span distances on, you will also see the span distance and bearing label located under the connection. As you move a pole, this will auto update using the new position. At this point, just click on the tool you need to use and make sure your map focus is on the correct starting location (yellow highlight).
*If you don’t have a tool you need or think you will use on a regular basis, you can go into the Model Editor to make the button and add it to the appropriate toolset.
If multiple spans go to the same location, use the join tool so that you don’t add extra points to the map. Just click your starting location, then choose what join tool you need to use.
Once you have a connection to draw, click the other location you need to join to. You will see the cursor turn into a pointing finger, then you can left click to join.
Using Imported Layers
If you have a KMZ or shapefile, you can either bring those in as reference layers or use them to seed locations and connections onto the map.
If you intend to use them as reference layers, you can go into the “Manage Layers” section of the Imported Layers dropdown.
This will open up the manage layers window. Here is where you can choose the file to import, or upload an image to use as a map overlay. You can also reach out to firstname.lastname@example.org to add Reference or API layers to assist in the predesign process.
Once you add a layer, the option to turn on the layer will appear under the “Imported Layers” dropdown. You can also click on the cursor icon to make the layer selectable or not.
If the layer is selectable, when you click on a section of the layer you will see the various options for it. Here you can edit the description, change the colors, change the geometry, copy the feature, delete a feature within the layer, or copy nodes out to another job.
Once the layer is configured as needed, click the cursor to deselect the layer under Imported Layers. This will enable you to place items directly over top or within the layer.
At this point, the design process would be the same as the basic method, where you can select the tools you need and draw locations directly onto the map.
If you choose to add an image overlay to the map, make sure to pick one of the approved file types. You can then click the “Choose File” button and search for your file you want to add.
If you click on the image, a Katapult node icon will appear. You can use this node to move the image around the map. If you need to rotate the image to match up, click on the photo again to add a second node point that you can use to rotate the image around.
If you need to move the photo again or change the rotation nodes, click on the “Reset Nodes” button in the window to start the process again.
You can also use the scroll bar in the middle of the window to change the image’s opacity. Once the image is set, click “Glue to Map” to have the image overlay be placed. Now you can return to the Imported Layers to turn on the overlay file and predesign within or over the image overlay as needed.
*The image overlay function is currently in development, so please pardon our bugs as this feature is being worked on. If you have issues or questions, please contact email@example.com.
Dragging Files Directly onto the Map
One of Katapult Pro’s easiest way to predesign is to seed locations directly onto the map. You can drag a KMZ with pole locations onto the map, or you can generate a .csv file or spreadsheet of the locations with metadata and drag that file on the map.
If you drag a KMZ or shapefile, the software will prompt you to choose attributes to add to the locations. If you are seeding poles you would add the attribute node_type and select pole. You may also want to add other attributes to each location depending on what data you need.
If you have a spreadsheet with your pole or node data, you can drag that file directly on the map as well to seed in the poles with the metadata. The poles will be placed according to the latitude and longitude. Then you should define the node_type so that the locations are placed as the correct type. Then make sure any other data you want matches up to an attribute in your models.
As you can see the attribute name will be the header located at the top of each column. If you do have data that doesn’t match a particular attribute, you will have an option to change it or have it map to something else when you drag the file onto the map.
You can use the dropdown menu to have the attribute map to something else or you can go into the Model Editor to add the attribute to the models then reupload the nodes.
Once the errors have been fixed, the “Add to Job” button will be available and the window will say “ Your data is ready to import!” The locations with the attribute data will then be seeded onto the map.
If you switch your toolset to the Office Power Tools, there will be a tool called Join All Poles. You can use this as a quick option to join the poles together.
It will string the poles together in a single line using aerial connection. So if your route has multiple breaks or branching sections, or if you are not doing aerial work, it may be best not to click this button.
You could also just use the regular join option found in the field tools to start joining the nodes together. For this, click on your starting node, then click the join option you want and click the next location to join the two with a connection.
Once your design is done, you are ready to send out the field crew to collect the data!
If you click on a node or connection, the node or connection info window will be displayed on the right hand side of the page. You can delete poles or connections by selecting the red “Delete” button at the bottom left of the window.
You can also change the connection type or node type at any time by selecting the dropdown and finding the correct option. These picklists are edited in the Model Editor.
Feel free to modify buttons to include multiple attributes on the draw action, especially with aerial tools. This allows you to not have to keep clicking the add attribute button in the node or connection info window each time.
You can use the Note button to drop in notes to the field crew to make them aware of things to look for while at a particular location. This is a good way to communicate from office to field and vice versa.
If you can’t properly see a pole on the map, feel free to add an attribute such as “Verify Location in Field” to the Node Info. Give that attribute a styling to show that the field crew should confirm the location once at the pole. You can also switch or add Map Bases to make locating poles easier.
If you accidentally move a location, you can press Control then “Z” to undo the move on the map.
Use street view to help locate poles or to see any taps or references coming off a pole. As you move or rotate in street view, the pegman will rotate and move on the map so you can see exactly where you are.
Aerial and Underground can be designed in the same job, just make sure to switch to the proper toolset under the Tools dropdown when designing.
Mobile will have the same capability and design functionality as desktop, so if design is needed from mobile, that is OK. Please refer to our Field Manual for more detail on using mobile.
Colors, styles, and icons can be adjusted using the Map Style Editor. Please refer to our Map Style Editor Documentation for more information.
Thanks for reading! For a more visual guide of the Pre-design, check out our Predesign Webinar video, coming soon!