reqreate 0.1.0__tar.gz

reqreate-0.1.0/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2018 The Python Packaging Authority
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

reqreate-0.1.0/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.4
+Name: reqreate
+Version: 0.1.0
+Summary: Instance generator for demand responsive transit systems
+Author-email: Michell Queiroz <michell.queiroz@uantwerpen.be>
+License: MIT
+Project-URL: Homepage, https://github.com/michellqueiroz-ua/instance-generator
+Keywords: transportation,dial-a-ride,openstreetmap,instance-generator,operations-research
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: osmnx<3,>=2.0
+Requires-Dist: networkx
+Requires-Dist: pandas
+Requires-Dist: numpy
+Requires-Dist: shapely
+Requires-Dist: matplotlib
+Requires-Dist: geopandas
+Requires-Dist: osmapi
+Requires-Dist: scipy
+Requires-Dist: geopy
+Requires-Dist: pyshp
+Requires-Dist: seaborn
+Requires-Dist: powerlaw
+Requires-Dist: fitter
+Provides-Extra: app
+Requires-Dist: streamlit; extra == "app"
+Requires-Dist: folium; extra == "app"
+Requires-Dist: streamlit-folium; extra == "app"
+Requires-Dist: plotly; extra == "app"
+Provides-Extra: parallel
+Requires-Dist: ray; extra == "parallel"
+Provides-Extra: analysis
+Requires-Dist: scikit-learn; extra == "analysis"
+Requires-Dist: sqlalchemy; extra == "analysis"
+Requires-Dist: sqlalchemy-utils; extra == "analysis"
+Dynamic: license-file
+
+# REQreate 🚌
+
+REQreate is a tool to generate instances for on-demand transportation problems. Such problems consist of optimizing the routes of vehicles according to passengers' demand for transportation under space and time restrictions (requests). REQreate is flexible and can be configured to generate instances for a large number of problems in this problem class. For example, the Dial-a-Ride Problem (DARP) and On-demand Bus Routing Problem (ODBRP). The tool makes use of real-life networks from OpenStreetMaps to generate instances for an extensive catalogue of existing and upcoming on-demand transportation problems.
+
+## ✨ New: Web Interface
+
+REQreate now includes a user-friendly web interface built with Streamlit! No need to edit JSON files manually.
+
+**Quick Start:**
+```bash
+pip install .[app]
+reqreate app
+```
+
+Or simply double-click `run_webapp.bat` (Windows)
+
+The web interface provides:
+- 🎨 Visual forms for all parameters
+- 📊 Browse and preview existing instances
+- �️ Interactive maps with request distribution visualization
+- 🔥 Heatmaps for demand density analysis
+- �🔄 Real-time generation progress
+- 📚 Built-in documentation
+- 💾 Easy data exploration
+
+See [WEBAPP.md](WEBAPP.md) for detailed instructions.
+
+## 🌐 Deploy Online
+
+Want to share REQreate with others? Deploy it to Hugging Face Spaces for free!
+
+**Hugging Face Spaces** (Recommended):
+- ✅ Free tier with 16GB RAM
+- ✅ No timeout issues
+- ✅ 50GB persistent storage
+- ✅ Automatic HTTPS
+
+**Quick Deploy:**
+1. Create account at [huggingface.co](https://huggingface.co/join)
+2. Create new Space with Streamlit SDK
+3. Push your code to the Space repository
+4. App automatically builds and deploys
+
+See [DEPLOYMENT_GUIDE.md](DEPLOYMENT_GUIDE.md) for detailed deployment instructions.
+
+## How to use REQreate?
+
+### Option 1: Web Interface (Recommended for new users)
+Use the Streamlit web app for a guided, visual experience:
+```bash
+python -m streamlit run app.py
+```
+
+### Option 2: Command Line (Advanced users)
+Attributes and parameters that define an instance are described in a configuration file given as input to REQreate. The used syntax is JSON.
+Each configuration file can generate one or more instances and it should be given as parameter in the REQreate.py file.
+Edit "REQreate.py" indicating the desired configuration file and a name for the output folder and simply run "python REQreate.py" on your terminal.
+Check out [this folder](https://github.com/michellqueiroz-ua/instance-generator/tree/master/examples/basic_examples) for examples of configuration files.
+
+# Questions? Do not hesitate to send an e-mail to:
+
+michell.queiroz@uantwerpen.be
+
+## Installation requirements
+
+### Quick Install (Recommended)
+
+1. **Install Python 3.11+** (required by osmnx 2.x)
+
+2. **Install REQreate** from a checkout of this repository:
+```bash
+pip install .[app]
+```
+
+3. **Run the tool:**
+   - Web Interface: `reqreate app` — opens the interface in your browser, running entirely on your machine
+   - Command Line: `reqreate generate my_config.json`
+   - `reqreate --help` lists every option
+
+Running the interface locally is the recommended way to use REQreate. Besides
+not depending on a hosted deployment, OpenStreetMap downloads then leave from
+your own IP address rather than one shared with every other user of a hosting
+platform, which is what gets requests refused by the public Overpass API.
+
+**Optional extras:**
+
+| Extra | Installs | Needed for |
+|---|---|---|
+| `parallel` | ray | parallel processing (the code falls back to sequential without it) |
+| `analysis` | scikit-learn, sqlalchemy | the taxi-dataset trip-pattern and `uber_movement` modules |
+
+```bash
+pip install .[app,parallel]
+```
+
+### Troubleshooting: Overpass API errors
+
+If generation fails with a connection error mentioning `overpass-api.de`, the
+public OpenStreetMap query servers are refusing or rate-limiting the request.
+This is unrelated to the location you asked for. REQreate retries and fails
+over across several mirrors automatically; if none of them work, set
+`REQREATE_OVERPASS_URL` to an Overpass instance you can reach:
+
+```bash
+export REQREATE_OVERPASS_URL=https://overpass.kumi.systems/api/interpreter
+```
+
+### Detailed Installation
+
+1. Have python 3.8 or a newer version installed
+
+2. Install anaconda (optional but recommended)
+	- [Tutorial 1 anaconda](https://problemsolvingwithpython.com/01-Orientation/01.00-Welcome/)
+	- [Tutorial 2 anaconda](https://docs.anaconda.com/anaconda/install/)
+
+3. Install OSMnx (necessary to retrieve the networks)
+	- [Tutorial OSMnx](https://osmnx.readthedocs.io/en/stable/installation.html)
+
+4. Install Streamlit (for web interface)
+```bash
+pip install streamlit
+```
+
+5. Activate your environment (if using conda):
+```bash
+conda activate ox
+```
+
+## Features
+
+- 🌍 **Real-world networks** from OpenStreetMap
+- 🚍 **Flexible configuration** for various on-demand transport problems
+- 📊 **Multiple output formats** (CSV, JSON, GraphML, Pickle)
+- 🎯 **Realistic request patterns** based on POI density
+- ⏱️ **Accurate travel times** using actual road speeds
+- 🖥️ **User-friendly web interface** for easy instance generation
+
+## Output Files
+
+REQreate generates comprehensive datasets including:
+- Bus station locations
+- Network topology (walk + drive)
+- Passenger requests with time windows
+- Travel time matrices
+- Zone definitions
+- Points of Interest (POIs)
+- Network visualizations
+
+

reqreate-0.1.0/README.md

@@ -0,0 +1,149 @@
+# REQreate 🚌
+
+REQreate is a tool to generate instances for on-demand transportation problems. Such problems consist of optimizing the routes of vehicles according to passengers' demand for transportation under space and time restrictions (requests). REQreate is flexible and can be configured to generate instances for a large number of problems in this problem class. For example, the Dial-a-Ride Problem (DARP) and On-demand Bus Routing Problem (ODBRP). The tool makes use of real-life networks from OpenStreetMaps to generate instances for an extensive catalogue of existing and upcoming on-demand transportation problems.
+
+## ✨ New: Web Interface
+
+REQreate now includes a user-friendly web interface built with Streamlit! No need to edit JSON files manually.
+
+**Quick Start:**
+```bash
+pip install .[app]
+reqreate app
+```
+
+Or simply double-click `run_webapp.bat` (Windows)
+
+The web interface provides:
+- 🎨 Visual forms for all parameters
+- 📊 Browse and preview existing instances
+- �️ Interactive maps with request distribution visualization
+- 🔥 Heatmaps for demand density analysis
+- �🔄 Real-time generation progress
+- 📚 Built-in documentation
+- 💾 Easy data exploration
+
+See [WEBAPP.md](WEBAPP.md) for detailed instructions.
+
+## 🌐 Deploy Online
+
+Want to share REQreate with others? Deploy it to Hugging Face Spaces for free!
+
+**Hugging Face Spaces** (Recommended):
+- ✅ Free tier with 16GB RAM
+- ✅ No timeout issues
+- ✅ 50GB persistent storage
+- ✅ Automatic HTTPS
+
+**Quick Deploy:**
+1. Create account at [huggingface.co](https://huggingface.co/join)
+2. Create new Space with Streamlit SDK
+3. Push your code to the Space repository
+4. App automatically builds and deploys
+
+See [DEPLOYMENT_GUIDE.md](DEPLOYMENT_GUIDE.md) for detailed deployment instructions.
+
+## How to use REQreate?
+
+### Option 1: Web Interface (Recommended for new users)
+Use the Streamlit web app for a guided, visual experience:
+```bash
+python -m streamlit run app.py
+```
+
+### Option 2: Command Line (Advanced users)
+Attributes and parameters that define an instance are described in a configuration file given as input to REQreate. The used syntax is JSON.
+Each configuration file can generate one or more instances and it should be given as parameter in the REQreate.py file.
+Edit "REQreate.py" indicating the desired configuration file and a name for the output folder and simply run "python REQreate.py" on your terminal.
+Check out [this folder](https://github.com/michellqueiroz-ua/instance-generator/tree/master/examples/basic_examples) for examples of configuration files.
+
+# Questions? Do not hesitate to send an e-mail to:
+
+michell.queiroz@uantwerpen.be
+
+## Installation requirements
+
+### Quick Install (Recommended)
+
+1. **Install Python 3.11+** (required by osmnx 2.x)
+
+2. **Install REQreate** from a checkout of this repository:
+```bash
+pip install .[app]
+```
+
+3. **Run the tool:**
+   - Web Interface: `reqreate app` — opens the interface in your browser, running entirely on your machine
+   - Command Line: `reqreate generate my_config.json`
+   - `reqreate --help` lists every option
+
+Running the interface locally is the recommended way to use REQreate. Besides
+not depending on a hosted deployment, OpenStreetMap downloads then leave from
+your own IP address rather than one shared with every other user of a hosting
+platform, which is what gets requests refused by the public Overpass API.
+
+**Optional extras:**
+
+| Extra | Installs | Needed for |
+|---|---|---|
+| `parallel` | ray | parallel processing (the code falls back to sequential without it) |
+| `analysis` | scikit-learn, sqlalchemy | the taxi-dataset trip-pattern and `uber_movement` modules |
+
+```bash
+pip install .[app,parallel]
+```
+
+### Troubleshooting: Overpass API errors
+
+If generation fails with a connection error mentioning `overpass-api.de`, the
+public OpenStreetMap query servers are refusing or rate-limiting the request.
+This is unrelated to the location you asked for. REQreate retries and fails
+over across several mirrors automatically; if none of them work, set
+`REQREATE_OVERPASS_URL` to an Overpass instance you can reach:
+
+```bash
+export REQREATE_OVERPASS_URL=https://overpass.kumi.systems/api/interpreter
+```
+
+### Detailed Installation
+
+1. Have python 3.8 or a newer version installed
+
+2. Install anaconda (optional but recommended)
+	- [Tutorial 1 anaconda](https://problemsolvingwithpython.com/01-Orientation/01.00-Welcome/)
+	- [Tutorial 2 anaconda](https://docs.anaconda.com/anaconda/install/)
+
+3. Install OSMnx (necessary to retrieve the networks)
+	- [Tutorial OSMnx](https://osmnx.readthedocs.io/en/stable/installation.html)
+
+4. Install Streamlit (for web interface)
+```bash
+pip install streamlit
+```
+
+5. Activate your environment (if using conda):
+```bash
+conda activate ox
+```
+
+## Features
+
+- 🌍 **Real-world networks** from OpenStreetMap
+- 🚍 **Flexible configuration** for various on-demand transport problems
+- 📊 **Multiple output formats** (CSV, JSON, GraphML, Pickle)
+- 🎯 **Realistic request patterns** based on POI density
+- ⏱️ **Accurate travel times** using actual road speeds
+- 🖥️ **User-friendly web interface** for easy instance generation
+
+## Output Files
+
+REQreate generates comprehensive datasets including:
+- Bus station locations
+- Network topology (walk + drive)
+- Passenger requests with time windows
+- Travel time matrices
+- Zone definitions
+- Points of Interest (POIs)
+- Network visualizations
+
+

reqreate-0.1.0/REQreate/2assign_bus_stops_zones.py

@@ -0,0 +1,147 @@
+import math
+import matplotlib.pyplot as plt
+import os
+import osmnx as ox
+import pandas as pd
+import shapely
+from shapely.geometry import Polygon
+from shapely.geometry import Point
+from pathlib import Path
+# Runnable as a script from inside this directory (python 2assign_bus_stops_zones.py) as well as
+# via `python -m REQreate.2assign_bus_stops_zones`; put the repository root on sys.path so the
+# REQreate package resolves either way.
+import os as _os, sys as _sys
+_sys.path.insert(0, _os.path.dirname(_os.path.dirname(_os.path.abspath(__file__))))
+
+from REQreate.instance_class import Instance
+
+
+def assign_bus_stops_to_zones():
+    pass
+
+if __name__ == '__main__':
+
+    place_name = "Chicago, Illinois"
+    save_dir = os.getcwd()+'/'+place_name
+    pickle_dir = os.path.join(save_dir, 'pickle')
+    network_class_file = pickle_dir+'/'+place_name+'.network.class.pkl'
+
+    network_directory = os.getcwd()+'/'+place_name
+
+    if Path(network_class_file).is_file():
+        inst = Instance(folder_to_network=place_name)
+
+    save_dir_csv = os.path.join(inst.save_dir, 'csv')
+
+    #zones = pd.read_csv(save_dir_csv+'/'+place_name+'.zones.csv')
+    #stations = pd.read_csv(save_dir_csv+'/'+place_name+'.stations.csv')
+
+    #zone1 70% requests
+    pt = inst.network.polygon.centroid
+    lon = pt.x
+    lat = pt.y
+    
+    earth_radius = 6371009  # meters
+    dist_lat = 2000
+    dist_lon = 2000
+
+    lat = lat
+    lng = lon
+
+    delta_lat = (dist_lat / earth_radius) * (180 / math.pi)
+    delta_lng = (dist_lon / earth_radius) * (180 / math.pi) / math.cos(lat * math.pi / 180)
+    
+    north = lat + delta_lat
+    south = lat - delta_lat
+    east = lng + delta_lng
+    west = lng - delta_lng
+                
+    #north, south, east, west = ox.utils_geo.bbox_from_point(zone_center_point, distance)
+    polygon1 = Polygon([(west, south), (east, south), (east, north), (west, north)])
+
+    #zone2 30% requests
+    earth_radius = 6371009  # meters
+    dist_lat = 2000
+    dist_lon = 2000  
+
+    lat = 41.767025
+    lng = -87.689840
+    
+
+    delta_lat = (dist_lat / earth_radius) * (180 / math.pi)
+    delta_lng = (dist_lon / earth_radius) * (180 / math.pi) / math.cos(lat * math.pi / 180)
+    
+    north = lat + delta_lat
+    south = lat - delta_lat
+    east = lng + delta_lng
+    west = lng - delta_lng
+                
+    #north, south, east, west = ox.utils_geo.bbox_from_point(zone_center_point, distance)
+    polygon2 = Polygon([(west, south), (east, south), (east, north), (west, north)])
+
+    
+    all_stations = []
+    #for indexz, zone in zones.iterrows():
+    stationslis = []
+    for index, row in inst.network.bus_stations.iterrows():
+
+        lon = inst.network.bus_stations.loc[index, 'lon']
+        lat = inst.network.bus_stations.loc[index, 'lat']
+        #polygon = shapely.wkt.loads(zone['polygon'])
+        print(type(polygon1))
+        pnt = Point(lon, lat)
+        if polygon1.contains(pnt):
+            stationslis.append(index)
+
+
+
+    stationslis2 = []
+    for index, row in inst.network.bus_stations.iterrows():
+
+        lon = inst.network.bus_stations.loc[index, 'lon']
+        lat = inst.network.bus_stations.loc[index, 'lat']
+        #polygon = shapely.wkt.loads(zone['polygon'])
+        print(type(polygon2))
+        pnt = Point(lon, lat)
+        if polygon2.contains(pnt):
+            stationslis2.append(index)
+
+    data = {
+        'Name': ['zone70', 'zone30'],
+        'stations': [stationslis, stationslis2]
+    }
+
+    df = pd.DataFrame(data)
+
+    df.to_csv('zones_uneven_demand.csv', index=False)
+
+    #all_stations.append(stationslis)
+
+    #zones['stations'] = all_stations
+
+    #zones = pd.DataFrame(zones)
+    #zones.to_csv(save_dir_csv+'/'+place_name+'.zones.csv')
+    
+
+    '''
+    path_tt_file = os.path.join(save_dir_csv, place_name+'.tt.matrix.stations.csv')
+    pd_travel_time_matrix = pd.DataFrame()
+    travel_time_matrix = []
+    for indexs1, station1 in stations.iterrows():
+        print(indexs1)
+        d = {}
+        d['station_index'] = indexs1
+        for indexs2, station2 in stations.iterrows():
+            sv = str(indexs2)
+            if indexs2 != indexs1:
+                dist_uv = inst.network._return_estimated_travel_time_drive(int(station1['osmid_drive']), int(station2['osmid_drive']))
+                d[sv] = dist_uv
+            else:
+                d[sv] = 0
+        travel_time_matrix.append(d)
+
+    xt = pd.DataFrame(travel_time_matrix)
+    pd_travel_time_matrix = pd_travel_time_matrix.append(xt, ignore_index=True)
+    pd_travel_time_matrix.set_index(['station_index'], inplace=True)
+    pd_travel_time_matrix.to_csv(path_tt_file)
+    '''

reqreate-0.1.0/REQreate/REQreate.py

@@ -0,0 +1,57 @@
+# Runnable as a script from inside this directory (python REQreate.py) as well as
+# via `python -m REQreate.REQreate`; put the repository root on sys.path so the
+# REQreate package resolves either way.
+import os as _os, sys as _sys
+_sys.path.insert(0, _os.path.dirname(_os.path.dirname(_os.path.abspath(__file__))))
+
+from REQreate.input_json import input_json
+#from streamlit import caching
+import os
+
+if __name__ == '__main__':
+
+    #caching.clear_cache()
+
+    #EDIT HERE
+    place_name = "Maastricht, Netherlands"
+    inst_directory = 'examples/maastricht/' #directory to which the configuration files are saved
+    base_save_folder_name = 'instancesMAASTRICHT' #give a unique folder name to save the instances
+    #EDIT HERE
+
+    directory = os.fsencode(inst_directory)
+
+    for instance in os.listdir(directory):
+
+        instance_filename = os.fsdecode(instance)
+        instance_filename = instance_filename.replace("._", "")
+
+        final_list = []
+
+        if os.path.isdir(place_name+'/json_format/'+base_save_folder_name):
+            
+            file_list = os.listdir(os.path.join(place_name, 'json_format', base_save_folder_name))
+
+            
+            for filex in file_list:
+                filex = filex.replace('_1.json', "")
+                filex = filex.replace('_2.json', "")
+                filex = filex.replace('_3.json', "")
+                filex = filex.replace('_4.json', "")
+                filex = filex.replace('_5.json', "")
+                filex = filex+'.json'
+
+                final_list.append(filex)
+
+        if instance_filename not in final_list:
+
+            if (instance_filename.endswith(".json")):
+                print(instance_filename)
+                #print("here")
+                try:
+                    input_json(inst_directory, instance_filename, base_save_folder_name)  
+                except FileNotFoundError:
+                    
+                    pass
+        else:
+            print('already FOUND')
+    

reqreate-0.1.0/REQreate/REQreate2.py

@@ -0,0 +1,67 @@
+# Runnable as a script from inside this directory (python REQreate2.py) as well as
+# via `python -m REQreate.REQreate2`; put the repository root on sys.path so the
+# REQreate package resolves either way.
+import os as _os, sys as _sys
+_sys.path.insert(0, _os.path.dirname(_os.path.dirname(_os.path.abspath(__file__))))
+
+from REQreate.input_json import input_json
+#from streamlit import caching
+import os
+
+if __name__ == '__main__':
+
+    #caching.clear_cache()
+
+    #EDIT HERE
+    place_name = "Chicago, Illinois"
+    inst_directory = '../examples/pricing_instances/'
+    #inst_directory = '../examples/testes/'
+    base_save_folder_name = 'pricing_example' #give a unique folder name to save the instances
+    #EDIT HERE
+
+    directory = os.fsencode(inst_directory)
+
+    #input_json(inst_directory+'/'+'Chicago,Illinois_ODBRP_7.0_8.0_300_0.0_300.0_0.0_180_1000.json')
+    
+    for instance in os.listdir(directory):
+
+        instance_filename = os.fsdecode(instance)
+        instance_filename = instance_filename.replace("._", "")
+
+        #print(os.listdir(os.path.join(place_name, 'json_format', base_save_folder_name)))
+
+        final_list = []
+
+        if os.path.isdir(place_name+'/json_format/'+base_save_folder_name):
+            
+            file_list = os.listdir(os.path.join(place_name, 'json_format', base_save_folder_name))
+
+            
+            for filex in file_list:
+                filex = filex.replace('_1.json', "")
+                filex = filex.replace('_2.json', "")
+                filex = filex.replace('_3.json', "")
+                filex = filex.replace('_4.json', "")
+                filex = filex.replace('_5.json', "")
+                filex = filex.replace('_6.json', "")
+                filex = filex.replace('_7.json', "")
+                filex = filex.replace('_8.json', "")
+                filex = filex.replace('_9.json', "")
+                filex = filex.replace('_10.json', "")
+                filex = filex+'.json'
+
+                final_list.append(filex)
+
+        if instance_filename not in final_list:
+
+            if (instance_filename.endswith(".json")):
+                print(instance_filename)
+                #print("here")
+                try:
+                    input_json(inst_directory, instance_filename, base_save_folder_name)  
+                except FileNotFoundError:
+                    
+                    pass
+        else:
+            print('already FOUND')
+    

reqreate-0.1.0/REQreate/REQreate3.py

@@ -0,0 +1,62 @@
+# Runnable as a script from inside this directory (python REQreate3.py) as well as
+# via `python -m REQreate.REQreate3`; put the repository root on sys.path so the
+# REQreate package resolves either way.
+import os as _os, sys as _sys
+_sys.path.insert(0, _os.path.dirname(_os.path.dirname(_os.path.abspath(__file__))))
+
+from REQreate.input_json import input_json
+#from streamlit import caching
+import os
+
+if __name__ == '__main__':
+
+    #caching.clear_cache()
+
+    #EDIT HERE
+    place_name = "Chicago, Illinois"
+    inst_directory = '../examples/high_dimension_instances/concert2/'
+    #inst_directory = '../examples/testes/'
+    base_save_folder_name = 'concert2' #give a unique folder name to save the instances
+    #EDIT HERE
+
+    directory = os.fsencode(inst_directory)
+
+    #input_json(inst_directory+'/'+'Chicago,Illinois_ODBRP_7.0_8.0_300_0.0_300.0_0.0_180_1000.json')
+    
+    for instance in os.listdir(directory):
+
+        instance_filename = os.fsdecode(instance)
+        instance_filename = instance_filename.replace("._", "")
+
+        #print(os.listdir(os.path.join(place_name, 'json_format', base_save_folder_name)))
+
+        final_list = []
+
+        if os.path.isdir(place_name+'/json_format/'+base_save_folder_name):
+            
+            file_list = os.listdir(os.path.join(place_name, 'json_format', base_save_folder_name))
+
+            
+            for filex in file_list:
+                filex = filex.replace('_1.json', "")
+                filex = filex.replace('_2.json', "")
+                filex = filex.replace('_3.json', "")
+                filex = filex.replace('_4.json', "")
+                filex = filex.replace('_5.json', "")
+                filex = filex+'.json'
+
+                final_list.append(filex)
+
+        if instance_filename not in final_list:
+
+            if (instance_filename.endswith(".json")):
+                print(instance_filename)
+                #print("here")
+                try:
+                    input_json(inst_directory, instance_filename, base_save_folder_name)  
+                except FileNotFoundError:
+                    
+                    pass
+        else:
+            print('already FOUND')
+