RayScale: A Neural Network-Based Intelligent Agricultural Sunlight Prediction System

A full-stack AI agricultural solution that uses artificial neural networks to predict Daily Global Irradiance (DGI), and combines real-time weather data to provide data-driven precise recommendations for agricultural decision-making.

In the process of global agricultural modernization, precision agriculture technology is becoming a key factor in improving crop yields and resource utilization efficiency. As a core environmental factor affecting plant photosynthesis and growth, sunlight conditions directly influence irrigation decisions, planting planning, and harvest predictions. However, traditional agricultural decisions often rely on empirical judgment or simple weather forecasts, lacking precise quantitative analysis of solar irradiance.

The RayScale project emerged as a solution—it is an AI-based full-stack intelligent agricultural system focused on predicting Daily Global Irradiance (DGI), and provides scientific decision support for farmers and agricultural practitioners through deep learning models.

RayScale adopts a modern full-stack architecture design, seamlessly integrating the machine learning backend with the responsive frontend:

The backend is built on the Python FastAPI framework, a high-performance asynchronous web framework especially suitable for machine learning model deployment. Core components include:

• Main Service Module (main.py): Provides RESTful API interfaces to handle prediction requests
• Pre-trained Model (model.pkl): Trained artificial neural network model file
• Model Configuration (model_config.json): Defines model input features and metadata
• Dependency Management (requirements.txt): Python environment dependency list

The frontend is built with React and Tailwind CSS, providing an intuitive user interaction interface:

• Main Application Component (App.jsx): Core application logic, responsible for communicating with the backend API
• UI Component Library (components/): Reusable interface components
• Utility Functions: Includes DGI calculator and OpenWeatherMap weather API integration

RayScale's neural network model accepts seven key environmental parameters as input:

1. DNI (Direct Normal Irradiance): Intensity of direct solar radiation
2. DHI (Diffuse Horizontal Irradiance): Amount of scattered radiation from the sky
3. KT (Clear Sky Index): Ratio of actual irradiance to theoretical maximum
4. Temperature: Ambient air temperature
5. Humidity: Relative air humidity
6. Wind Speed: Ground wind conditions
7. Precipitation: Amount of rain or snowfall

These features are carefully selected to cover the main atmospheric and environmental factors that affect solar radiation reaching the Earth's surface.

When a user submits a prediction request through the frontend interface, the system executes the following process:

1. Data Collection: The frontend obtains real-time weather data from user input or the OpenWeatherMap API
2. Feature Construction: The backend constructs the input array according to the feature order defined in model_config.json
3. Model Loading: The system loads the pre-trained neural network model from model.pkl
4. Prediction Calculation: The model outputs the DGI prediction value (range 0-1)
5. Result Interpretation: Generates irrigation recommendations and crop management labels based on the DGI value
6. Visualization: The frontend dashboard displays the prediction results and recommended solutions

Considering scenarios of unstable networks or temporarily unavailable backend services, RayScale has designed an elegant degradation strategy. When the backend is offline, the frontend automatically switches to a simulation calculation mode based on mathematical formulas, ensuring the user interface is always available. This design reflects the robustness thinking in engineering practice.