==================== Tech Support and FAQ ==================== What to do when you have a problem or request? First, we recommend you to take a look at our :ref:`question list ` below. If you don't find the answer to your question, use the support chat or report the problem from Pathfinder itself, so it goes directly into our issue management system. Support Chat ============ You can find the support chat link in the Help menu: .. image:: ./images/supportChatMenu.jpg :align: center :width: 20% And you can also open it from the button in the top bar: .. image:: ./images/supportChatBtn.jpg :align: center :width: 40% The chat dialog will open. Please provide a user name and email, and click on "Start the chat": .. image:: ./images/chatLogin.jpg :align: center :width: 50% Then, type your message and attach sample data or screenshots related to your problem or question. .. image:: ./images/chatDialog1.jpg :align: center :width: 50% A tech support associate will respond to you as soon as possible. .. image:: ./images/chatDialog2.jpg :align: center :width: 50% .. note:: *If you have an Ad Block or Privacy Web browser extension active for the Pathfinder site, it may prevent the application from showing the chat window. If the chat button is not visible, disable these extensions for Pathfinder.* Report a Bug ============ If you find a problem with the software, you can report it directly to us, using this menu option: .. image:: ./images/reportBugMenu.jpg :align: center :width: 20% Your default email application will open to send an email to our internal issue tracking system. .. image:: ./images/reportBugMail.jpg :align: center :width: 60% To make your report email more effective, please: - Describe the steps you follow to find the problem - Attach an image or video capture - If the problem is data-specific, attach some sample data to reproduce the issue .. _question_list: Common Questions ================ * :ref:`How to prepare data for Pathfinder? ` * :ref:`I get a login error. What should I do? ` * :ref:`I can't find my original data. ¿Is is possible to download them from Pathfinder? ` * :ref:`How can I create a project thumbnail? ` * :ref:`What is the maximum area size (or minimum resolution value) I can use? ` * :ref:`What is the source of elevation data (digital terrain model) of Pathfinder? ` * :ref:`Things get very slow when adding large datasets. What can I do? ` * :ref:`I don't see the base datasets listed when I try to add a new layer ` * :ref:`The calculated path is too long. How can I reduce its length? ` * :ref:`We use our own pylon/structures models. How can they be added to Pathfinder? ` * :ref:`I would like to setup my own background image ` * :ref:`I don't see the support chat button or dialog ` * :ref:`How to impose a 90-degree crossing over linear features? ` * :ref:`How to force the path to follow linear features like roads or existing transmission lines? ` * :ref:`How can I avoid the path from crossing forbidden areas between pylons? ` * :ref:`I get an error about points being in a forbidden area. What should I do? ` * :ref:`The path generation fails to calculate a path. Why? ` * :ref:`I don't see the same algorithms and geoprocesses shown in the manual. Where are they? ` * :ref:`I've changed the rings or resistances in the project/scenario, but the path doesn't change when I recalculate it.` * :ref:`Sometimes the map view is split, with a lower white area and there is no way to restore it.` .. _data_preparation: Data Preparation ---------------- A common question asks how to prepare data to be used in Pathfinder. This figure summarizes the criteria and most frequent steps for preparing vector data. .. image:: ./images/DataPreparation.jpg :align: center :width: 90% If your organization needs help to prepare data, check our data preparation services. .. _login_failure: Login Failure ------------- If you login into Pathfinder from a different computer, or after a long time, you might get this error message: .. image:: ./images/invalidToken.jpg :align: center :width: 40% In this case, just click on the "Logout" button in the right corner of the top bar, and log in again. If you have problems logging with the "Remember me" option on, check this option off before logging. .. _recover_data: Recover original data --------------------- You can download the original vector or raster data uploaded to create a base dataset, by using the :ref:`Admin tool `. .. _project_thumbnail: Project Thumbnail ----------------- If you wonder how to change the default project thumbnail visible in the landing page, you can do so in the :ref:`Project Information ` dialog. .. image:: ./images/uploadThumbnail.jpg :align: center :width: 40% .. _max_area: Maximum Area/Resolution ----------------------- In principle, a project may have any area size. However, the product of the area by the resolution is limited to certain number. By default, the limit is 5,000. This means that at 10m resolution you can only work with an area that is 50x50 Kms. If you need to work with a larger area, you will also need to increase the size of the resolution value. For instance, you can work with a 500x500 Kms area, but increasing the resolution size to 100m. Gilytics support can increase the maximum size number to 16,000. However, this may slow down your data processes and cause failures for large datasets. If you still want us to increase this size, let us know. Changing Project Area or Resolution ----------------------------------- Sorry, it's not possible to change the project area of its resolution after is has been created. The reason for this is that important internal data like the digital elevation model and slope are setup after the project creation and affect its layers. If you need to modify the project area or resolution, do this: * Save the scenarios in your current project to the :ref:`Scenario Catalog `. * Create the new project. * In the new project wizard, or in the Add New Layers dialog, click on "Copy from another project" and select the original project: .. image:: ./images/CopyBuffers.jpg :align: center :width: 25% * After the layers are processed, create the scenarios and import them from the ones you saved in the Scenario Catalog. * Remove the original project if you don't need it anymore. .. _dem_source: Elevation Sources ----------------- A digital elevation model layer is automatically added to Pathfinder projects :ref:`when they are created `. This layer uses data from the `Tilezen Terrain Tiles `_ hosted by AWS. This data service is mostly based on the `Global SRTM terrain data `_. This dataset is geoid-corrected, meaning that it's values represent height above the sea level. .. image:: ./images/mapzen-example.jpg :align: center :width: 90% On the other hand, the `Cesium World Terrain Layer `_ in used in Pathfinder's 3D View. Its resolution varies quite a lot from a few meters to one kilómeter depending on the region. This elevation source provides ellipsoidal values, meaning elevation about the average global ellipsoid, so the elevation values at sea level are not necessarily zero. However, these elevation values are only used for 3D visualzation and do not affect the data products generated by Pathfinder. .. image:: ./images/cesium_terrain3D.jpg :align: center :width: 90% .. _max_data_size: Maximum Data Size ----------------- Some processes may have problems, taking a long time, even failing, for large datasets (with many features, or very complex geometries). If you try to upload data (e.g. a zipped Shapefile) *larger than 50 MB*, we recommend you to simplify it or split it into multiple datasets using GIS software, so all the processing will be faster. .. _baselayer_missing: Base Datasets not Listed ------------------------ After :ref:`uploading a base dataset `, the user needs to :ref:`create layers ` from the company datasets. However, it may happen that the datasets are not listed in the "Uploaded" tab. Why? .. image:: ./images/addLayerDlg.jpg :align: center :width: 90% * The dataset might already be used by some other layer in the project. In this case, look for it in the "Included" tab. * The dataset does not have a valid extent (may be empty) or its extent does not intersect our project area. This may happen if the coordinate system was incorrectly assigned in the original data source, or because some other data processing issues. To check that the extent of an uploaded base dataset seems correct, take a look at the :ref:`base layers admin page `. .. image:: ./images/baselayer_extent.jpg :align: center :width: 90% .. _optimize_length: Optimize Route Length --------------------- The length of a route is an important cost factor, so it is usually convenient to reduce it as much as possible. The user can **manually** shorten the path length by reduce the relative resistance differences between layers (make their differences less important) while keeping approximately the same relative absolute values. For instance, if layers have initial resistance values like 2, 3 and 4, scaling up these values to 20, 30 and 40 will make no difference: the resulting path will stay the same. What we can do is to use values like 22, 23 and 24; or 32, 33 and 34, which reduce the relative difference between the layers. This scaling is done **automatically** by using the :ref:`length optimization factor ` in the scenario settings. The higher the value of this factor (near 1.0), the smoother and more straight the path will be, at the expense of other optimization criteria. Also, you can consider using an advanced algorithm with pylon spotting and set an :ref:`angle weight ` to make the path smoother. .. _custom_pylons: Custom Pylons ------------- The company administrator can :ref:`add custom pylons to Pathfinder `, but we can also do it for you. To do so, we need: * A 3D model of the pylon, best in `glTF/glb format `_, but it can be in 3DS, OBJ, FBX or other 3D file format. * The real height in meters of the pylon. .. _custom_images: Custom Background Image ----------------------- It is possible to use your own image or tiled Web Map Service as background map in the 2D and 3D views. Contact us and we will help you to set it up. .. _chat_not_visible: Chat Not Visible ---------------- As mentioned earlier, if you have an Ad Block or Privacy Web browser extension active for the Pathfinder site, it may prevent the application from showing the chat window. If the chat button is not visible, disable these extensions for Pathfinder. Also, the chat will not be visible if you did not accept the use of cookies, which are needed by this feature. .. _right_angles: 90-Degree Crossings ------------------- A common constraint for routing is to favor 90-degree crossings of other linear infrastructures like highways or transmission lines. The routing model of Pathfinder is designed so this constraint is applied automatically, just by: * :ref:`Creating a ring or buffer ` on the linear elements for which we want to optimize the crossings * Set a relatively high resistance to the layer containing the linear elements With these conditions, the routing algorithm will try to minimize the length over the linear feature, and therefore, will cross it near 90-degree angles, unless other constraints are given more priority (for instance, :ref:`reducing the route length `). .. image:: ./images/rightAngles.jpg :align: center :width: 80% .. note:: *The larger the buffer or ring distance around the lines compared to the project resolution, the better the 90-degree angle will be approximated. For instance, if your project resolution is 10 meters, a buffer of 100m or 150m will induce more precise perpendicular crossings than a buffer of 30 or 40 meters.* .. _bundling: Bundling with Existing Lines ---------------------------- In some cases, we would like the route to run close to existing roads or transmission lines, reducing the right of way, and the cost of construction and maintenance. We can use :ref:`per-ring resistances ` to achieve this "bundling" effect. Usually, we should set a high resistance close to the lines we don't want to cross too often, but we can also set a negative or small resistance in a second or third ring, at the right distances, to favor routes which are not too far from the existing lines. This image shows the bundling effect achieved by applying this technique: .. image:: ./images/bundling.jpg :align: center :width: 80% .. _forbidden_crossing: Prevent Crossing Forbidden Areas -------------------------------- If you need to prevent strictly the path from crossing forbidden areas, you must use the :ref:`algorithms including pylon spotting `, disabling the "between points allowed" choice in the :ref:`advanced options`. .. _forbidden_points: Points in Forbidden Areas ------------------------- When calculating a corridor, it may fail with the following message in the Process Log: .. image:: ./images/forbiddenPoint.jpg :align: center :width: 30% The problem here is that the Start, End or intermediate points of the path lies within a forbidden area, so a route is not possible. You must either: - Change the FB value of the layer the points is in to a high-resistance value - :ref:`Move the problem point ` out of the forbidden area .. _path_not_found: Failure with Forbidden Areas ---------------------------- Algorithms may fail to find a path when :ref:`large or long forbidden areas are defined `, or they generate unexpected results. For this reason, and because of the strong restrictions they impose, it is recommended to limit the use of forbidden areas, especially for large linear features like highways or rivers. .. _algos_not_visible: Algorithms or geoprocesses not visible -------------------------------------- Some of the Pathfinder calculations (:ref:`MCDAs, routing algorithms `, :doc:`geoprocesses `) may not be available by default to all companies. Check with Gilytics if you need to use some of these calculation options and they are not visible to you. .. _recalculate_path: The path(s) doesn't change after modifying parameters ----------------------------------------------------- Some changes require recalculating the Resistance Map and Corridor so that they affect the routing and therefore the path is correctly recalculated. So if you change: * The layer rings * The layer resistances * The MCDA or other scenario options like the length optimization factor you will need to *recalculate the Resistance Map and Corridor* again so those changes are reflected in the routing. You can force this recalculation by using the :ref:`Generate All ` button in the scenario. .. _map_split: The map view is split with a white bottom ----------------------------------------- Sometimes, when using the layer side panel to edit a layer's resistance options, the map view may be split in two and there is no apparent way to restore it. .. image:: ./images/splitMap.jpg :align: center :width: 90% Unfortunately, this issue happens randomly and it has proved difficult to fix. If this happens, you can restore the normal map by reloading the Pathfinder web page and the project, or using one of the Generate buttons. .. include:: footer.rst