Skip to content

Commit ab2ecb2

Browse files
authored
Update README.md
1 parent c80ae59 commit ab2ecb2

File tree

1 file changed

+66
-7
lines changed

1 file changed

+66
-7
lines changed

README.md

+66-7
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,75 @@
1-
# Dijkstra Use JavaFX
1+
# GIS Route Finder using Dijkstra's Algorithm
22

3-
![image](https://github.com/qossayrida/QossayRida/assets/59481839/a02432a6-088d-4441-a8e1-2a55a3148dab)
3+
This project implements an optimized version of Dijkstra's shortest path algorithm for geographic information systems (GIS), such as those used in MapQuest and GPS-based navigation systems. The program computes the shortest route between cities on a map based on Euclidean distances and displays the route on a visual map interface.
44

5-
![image](https://github.com/qossayrida/QossayRida/assets/59481839/9ea10e13-e9d9-4867-b612-d5eb0f58c344)
5+
## Features
66

7-
![image](https://github.com/qossayrida/QossayRida/assets/59481839/78230742-e575-47b7-b224-bd3635320fa1)
7+
1. **Interactive Map Interface**: Select cities using mouse and keyboard inputs.
8+
2. **Shortest Path Calculation**: Finds and displays the lowest-cost route between two selected cities.
9+
3. **Dynamic Route Display**: The route is shown visually on the map.
10+
4. **Optimized for Large Maps**: Efficiently handles maps with at least 50 cities and thousands of edges.
11+
5. **Map Preprocessing**: Speeds up repeated shortest path queries by reusing previous computations.
812

9-
![image](https://github.com/qossayrida/QossayRida/assets/59481839/97888a91-226b-4845-9903-0c281c0c9258)
13+
## File Format
14+
15+
The map is represented in a text file with the following structure:
16+
17+
Number of vertices (cities)
18+
Number of edges (roads)
19+
City1 Latitude1 Longitude1 0 (0 means this road cross)
20+
City2 Latitude2 Longitude2 1 (1 means this city)
21+
...
22+
Edge1_City1 Edge1_City2
23+
Edge2_City1 Edge2_City2
24+
...
25+
26+
Example:
27+
28+
6
29+
9
30+
City1 31.52583 34.45250 1
31+
City2 31.53389 35.09944 1
32+
City3 31.52972 34.48139 1
33+
City4 31.35611 34.30139 1
34+
City5 31.90000 35.20417 1
35+
cross1 31.70639 35.20167 0
36+
City1 City2
37+
City1 City4
38+
City2 City3
39+
City2 City5
40+
City3 City5
41+
City3 City4
42+
City3 cross1
43+
City4 cross1
44+
City5 cross1
45+
46+
## How to use
47+
Upon launching the application, you will be greeted with the Welcome Screen. Here you can choose to
48+
49+
![image](https://github.com/qossayrida/QossayRida/assets/59481839/a02432a6-088d-4441-a8e1-2a55a3148dab)
50+
51+
- **Choose Data manuale:**
52+
53+
Selecting Upload data from xlsx file will open a file dialog where you can choose an xlsx file from your computer that contains the data ,then choose the image for map
54+
55+
![image](https://github.com/qossayrida/QossayRida/assets/59481839/bbe52e4d-b9a7-4291-8a65-b44ac4f61b90)
56+
57+
- **Gaza Map:**
58+
59+
You'll be prompted to choose the source city from ComboBox or click on it in the map, and the same for the destination city, then you click at Find button the shortest path will found
60+
61+
![image](https://github.com/qossayrida/QossayRida/assets/59481839/9ea10e13-e9d9-4867-b612-d5eb0f58c344)
62+
63+
![image](https://github.com/qossayrida/QossayRida/assets/59481839/97888a91-226b-4845-9903-0c281c0c9258)
64+
65+
66+
- **Palestine Map:**
67+
68+
You'll be prompted to choose the source city from ComboBox or click on it in the map, and the same for the destination city, then you click at Find button the shortest path will found
69+
70+
![image](https://github.com/qossayrida/QossayRida/assets/59481839/22e2ceef-bda3-42e0-993c-96de6defe3fb)
1071

11-
![image](https://github.com/qossayrida/QossayRida/assets/59481839/22e2ceef-bda3-42e0-993c-96de6defe3fb)
1272

13-
![image](https://github.com/qossayrida/QossayRida/assets/59481839/bbe52e4d-b9a7-4291-8a65-b44ac4f61b90)
1473

1574

1675

0 commit comments

Comments
 (0)