From c09d3f94da6db35310f5b4ef06c3dffaa2b07518 Mon Sep 17 00:00:00 2001
From: lexara-prime-ai <irfanghat@gmail.com>
Date: Tue, 11 Jun 2024 12:22:06 +0000
Subject: [PATCH] Added [/docs], updated postcreateCommand path

---
 .devcontainer/devcontainer.json |  2 +-
 docs/README.md                  | 94 +++++++++++++++++++++++++++++++++
 2 files changed, 95 insertions(+), 1 deletion(-)
 create mode 100644 docs/README.md

diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
index 513380f..4562218 100644
--- a/.devcontainer/devcontainer.json
+++ b/.devcontainer/devcontainer.json
@@ -5,7 +5,7 @@
 		"dockerfile": "../Dockerfile"
 	},
 	"forwardPorts": [8000],
-	"postCreateCommand": "bash ./scripts/bash/entrypoint.sh",
+	"postCreateCommand": "bash /scripts/bash/entrypoint.sh",
 	"customizations": {
 	  "vscode": {
 		"extensions": [
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 0000000..4a8d627
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,94 @@
+# Questions this project aims to answer
+## Descriptive Questions
+
+1.  **General Statistics:**
+    
+    -   What is the total number of spots recorded in a given time period?
+    -   How many unique receivers and transmitters are there in the data?
+2.  **Time-Based Analysis:**
+    
+    -   What is the distribution of spots over different times of the day or days of the week?
+    -   How does the number of spots vary over different months?
+3.  **Geographical Analysis:**
+    
+    -   What are the most common receiver and transmitter locations (latitude and longitude)?
+    -   What is the average distance between transmitters and receivers?
+
+### Analytical Questions
+
+1.  **Signal Propagation:**
+    
+    -   How does the signal-to-noise ratio (SNR) vary with distance?
+    -   What is the relationship between power and distance?
+2.  **Frequency and Band Analysis:**
+    
+    -   How does the frequency distribution look like across different bands?
+    -   Which band has the highest average SNR?
+3.  **Performance Analysis:**
+    
+    -   Which version of the software (Version) shows the best performance in terms of SNR?
+
+### Comparative Questions
+
+1.  **Temporal Comparison:**
+    
+    -   How does the signal propagation vary between different times of the day (e.g., day vs. night)?
+    -   How does the performance vary across different months?
+2.  **Geographical Comparison:**
+    
+    -   How does the SNR differ between different geographical regions?
+    -   How does the distance vary between different receiver and transmitter locations?
+
+### Complex Analysis
+
+1.  **Pattern Recognition:**
+    
+    -   Can we identify any patterns in the data that suggest certain times or conditions are better for signal transmission?
+    -   Are there any anomalies or outliers in the data that require further investigation?
+2.  **Predictive Analysis:**
+    
+    -   Can we predict the SNR based on other variables such as distance, power, frequency, and band?
+    -   Can we build a model to predict the best times and conditions for signal transmission?
+
+### Example Queries
+
+1.  **Basic Query:**
+    
+    -   How many spots were recorded on the 3rd band on June 10, 2024?
+    
+```sql
+SELECT COUNT(*) 
+FROM wspr_data 
+WHERE Band = 3 AND Date(Time) = '2024-06-10';
+``` 
+    
+2.  **Signal-to-Noise Ratio Analysis:**
+    
+    -   What is the average SNR for each band?
+    
+```sql
+SELECT Band, AVG(SNR) 
+FROM wspr_data 
+GROUP BY Band;
+``` 
+    
+3.  **Distance and SNR Relationship:**
+    
+    -   What is the correlation between Distance and SNR?
+    
+```sql
+SELECT CORR(Distance, SNR) 
+FROM wspr_data;
+``` 
+    
+4.  **Geographical Distribution:**
+    
+    -   What are the top 5 transmitter locations by the number of spots?
+    
+```sql
+SELECT TX_Loc, COUNT(*) as SpotCount 
+FROM wspr_data 
+GROUP BY TX_Loc 
+ORDER BY SpotCount DESC 
+LIMIT 5;
+``` 
\ No newline at end of file