How to Resolve the FileNotFoundError When Running FLOW's OSM Simulation Tutorial

Learn how to fix the common `FileNotFoundError` encountered in the FLOW project guide "Networks from OpenStreetMap" and ensure SUMO is properly configured for your simulations. --- This video is based on the question https://stackoverflow.com/q/62534274/ asked by the user 'Anjie Qiu' ( https://stackoverflow.com/u/7365747/ ) and on the answer https://stackoverflow.com/a/62551527/ provided by the user 'Anjie Qiu' ( https://stackoverflow.com/u/7365747/ ) at 'Stack Overflow' website. Thanks to these great users and Stackexchange community for their contributions. Visit these links for original content and any more details, such as alternate solutions, latest updates/developments on topic, comments, revision history etc. For example, the original title of the Question was: File error while running the guide06 "Networks from OpenStreetMap" from FLOW project Also, Content (except music) licensed under CC BY-SA https://meta.stackexchange.com/help/l... The original Question post is licensed under the 'CC BY-SA 4.0' ( https://creativecommons.org/licenses/... ) license, and the original Answer post is licensed under the 'CC BY-SA 4.0' ( https://creativecommons.org/licenses/... ) license. If anything seems off to you, please feel free to write me at vlogize [AT] gmail [DOT] com. --- How to Resolve the FileNotFoundError When Running FLOW's OSM Simulation Tutorial When diving into the FLOW project and working through its guide on creating networks from OpenStreetMap (OSM), you might encounter a frustrating FileNotFoundError. This error suggests that necessary XML network configuration files are missing and can halt your simulation progress. Fortunately, there’s a straightforward pathway to troubleshoot and resolve this issue, so let's break it down step-by-step! Understanding the Problem In the guide, you are expected to use an .osm file to run a simulation successfully. The snippet of code provided is set up to create your network using the bay_bridge.osm file. However, upon running the code, you might see an error akin to: [[See Video to Reveal this Text or Code Snippet]] This indicates that the system cannot locate the corresponding XML file that should be generated from the OSM file. The likely cause? An issue with the conversion process that utilizes the netconvert tool from SUMO, specifically due to libraries needed for projections. The Solution: Ensuring SUMO is Built with PROJ To resolve this error, follow these organized steps to install the necessary packages and rebuild SUMO with the required library support. Step 1: Verify PROJ Library Installation Check for PROJ installation: Ensure you have the PROJ library installed on your system. If not, install it using the following command line (the method may vary based on your operating system): [[See Video to Reveal this Text or Code Snippet]] Building SUMO with PROJ: If you find that the SUMO was built without PROJ support, you will have to recompile it. When you do this, you might run into issues specifically related to a file named proj_api.h that might not be detected. Step 2: Troubleshooting Header File Issues If you encounter an error indicating that proj_api.h is not found, but you can see it existing in /usr/local/include/, then you may need to adjust the configuration file. Edit proj_api.h: Open /usr/local/include/proj_api.h in a text editor with root permissions. You can do this via terminal using: [[See Video to Reveal this Text or Code Snippet]] Modify the file: Look for the line that suggests defining the macro for deprecations and comment it out, or define the macro as follows: [[See Video to Reveal this Text or Code Snippet]] Step 3: Rebuild SUMO Reconfigure and rebuild: After making the changes to proj_api.h, proceed to run the following commands from your SUMO source directory: [[See Video to Reveal this Text or Code Snippet]] Confirm successful installation: Ensure that no errors are thrown during the build process. Once built, you should be ready to run your simulations again! Step 4: Running Your Simulation With the right configurations in place, you can now go back to your Jupyter notebook and re-run the following command: [[See Video to Reveal this Text or Code Snippet]] If everything is set up correctly, your simulation should run without the earlier encountered error, successfully using the .osm file! Conclusion While encountering a FileNotFoundError may seem daunting, understanding that this is usually related to missing dependencies can make troubleshooting much easier. By ensuring that you have the required libraries and properly configuring them, you can effectively continue experimenting with the FLOW project and its guides. Happy coding!