README.md

---
title: City_Network_Visualizer
emoji: 🐢
colorFrom: yellow
colorTo: yellow
sdk: gradio
sdk_version: 5.1.0
app_file: app.py
pinned: false
---

This is a dashboard that displays networks of narrators for a given City or Region and Time period. The inputs
and interpreting the network visual, so i will explain them here. The city input and the time period inputs are self 
explanatory. The y-axis input is what quantity you want to display: it can be Hadith's transmitted, Isnads, or Tarafs. 
That is because the dataset i am using to make this dashboards has the number of hadith, tarafs, and isnads for each
Teacher-Student relationship. So for example , Abu Hurayrah and the Prophet ﷺ would have a certain number of hadith
that they are involved in, a certain number of isnads, and a certain number of tarafs. 


The number of narrators input will retieve the number of narrators by the highest values of the variable you wish to visualize. 
If the number of narrators surpases the total number of Narrator relationships in the selected time period, all the Narrators are displayed.
If you select a large number of narrators, the output graph will look chaotic, but it will have insightful information.
The resulting network graph has nodes, which are the circles where each narrator is, and the edge, which is 
the transmission from narrator to another narrator. If the color of the text of the node is red, then they are a recipient of
the hadith. If the color of the text is yellow, they are the transmitter. The color of the node corresponds to the value
of the variable being displayed of that narrator, wether they are a student or a teacher. This means I am not simultaneously 
displaying both number of hadith recieved and the number of hadith transmitted. To figure out wether the value in the circle
is number of hadith recieved, the text of their name will be red. Very important!


The black text is the number of hadith transmitted between Transmitter and Recipient. It also displays the teacher and
student so you can keep track of the value. For large numbers of narrators selected, the resulting graph will look chaotic.
However, you can highlight the narrator of transmission between two narrators by double clicking the node or edge- 
all narrators and transmissions that are part of that transmission will be boldened. This will make it easier to
find the values you will need. 

The coloring scale, and the thickness of the edges depend on the number of hadith, Taraf, Isnad between each narrator. 
Keep in mind that since Hadith isnads overlap, the values of the nodes is not totally accurate. The edge information however, is. 
The coloring scale for this is called 'cool' from Matplot lib. It goes from light blue to hot pink. you can google the exact color
scales for now, until i figure out how to upload the image to this readme file.