Merge pull request #1025 from Avaiga/doc/#1024-add-commodity-trading-…

…application

Add commodity trading application

docs/gallery/decision_support/3_production_planning/index.md

@@ -5,8 +5,15 @@ data-keywords: optimization scenario cycle comparison enterprise
 short-description: Simulate manufacturing scenarios and optimize production quantities to reduce production costs.
 img: 3_production_planning/images/production-planning-data-visualization.png
 ---
-Optimizing resources to meet demand while minimizing costs is pivotal in manufacturing. This is why 
-production planning tools are mandatory in manufacturing.
+
+All manufacturers must generate a production plan over a given horizon (here, several 
+months). The objectives are to produce an optimized plan that respects the plant's 
+capacity constraints. The Optimization step ensures that the plan meets as much of the 
+demand as possible while minimizing production costs. 
+
+Although small, this example perfectly illustrates the basic requirements. The 
+application presented here can easily be extended to cater to more complex real use cases.
+
 
 !!! note "Taipy Enterprise edition"
 

docs/gallery/decision_support/3_qsr_sales_forecasting/index.md

@@ -5,11 +5,14 @@ data-keywords: ai scenario datanode dag configuration enterprise
 short-description: Perform sales forecasting for a renowned quick service restaurant (QSR) franchise.
 img: 3_qsr_sales_forecasting/images/forecast_page.png
 ---
-This demo is a scaled-down version of a production application using Taipy, which 
-performs sales forecasting for a renowned quick service restaurant (QSR) franchise. This 
-business problem involves time series forecasting for several core business activities of 
-the QSR, such as sales made on drinks or the number of transactions made at the front 
-counter.
+
+This demo is a scaled-down version of a real application using Taipy, which performs 
+sales forecasting for a renowned quick-service restaurant (QSR) franchise. This business 
+problem involves time series forecasting for several drivers (number of items sold, 
+revenue, number of transactions, etc.) for different store sections (drive-thru, counter, café 
+corner, etc.). High-quality sales forecasts are generated using powerful AI models and 
+various data sources. This demo can easily be extended to reflect specific store 
+requirements.
 
 !!! note "Taipy Enterprise edition"
 

docs/gallery/decision_support/bar_cutting/index.md

@@ -5,10 +5,12 @@ data-keywords: optimization scenario enterprise
 short-description: Use two scenarios with distinct algorithms to reduces raw material waste by bar cut sizes optimizations.
 img: bar_cutting/images/bar-cutting-bar-Visualization.png
 ---
-This demo showcases how to optimize the bar-cutting process
-to minimize waste. Bar-cutting optimization minimizes waste
-by choosing optimal cutting patterns. This is crucial in industries
-with significant material costs such as Steel, Timber, etc.
+
+This demo showcases how to optimize the bar-cutting process to minimize waste. 
+Bar-cutting optimization minimizes waste by choosing optimal cutting patterns. This is 
+crucial in industries with significant material costs, such as Steel and timber. This 
+demo embeds a powerful optimization engine that has demonstrated huge savings for several 
+large companies. It can easily be extended to cater for specific requirements.
 
 !!! note "Taipy Enterprise edition"
 

docs/gallery/finance/commodity_trading/index.md

@@ -0,0 +1,119 @@
+---
+title: Commodity Trading
+category: finance
+data-keywords: dashboard vizelement layout chart ai multi-page classification enterprise
+short-description: A Taipy Application that analyzes commodity trading.
+img: commodity_trading/images/commodity_trading.png
+---
+
+This application illustrates a typical environment for Commodity Trading. It uses an AI 
+engine that provides sell/buy recommendations (Short/Long) for the various 
+products, together with an explanation of the main influencers that contributed 
+the most to the decision. 
+
+This application can be customized for different sets of commodities. 
+
+!!! note "Taipy Enterprise edition"
+
+    Taipy provides robust, business-focused applications tailored for enterprise environments. To 
+    maintain standards of security and customization, these applications are proprietary like this 
+    application. If you’re looking for solutions that are immediately deployable and customizable to 
+    your business needs, we invite you to try them out and contact us for more detailed information.
+
+    [Try it live](https://commodity-trading.taipy.cloud){: .tp-btn target='blank' }
+    [Contact us](https://taipy.io/book-a-call){: .tp-btn .tp-btn--accent target='blank' }
+
+
+![Page](images/commodity_trading.png){width=90% : .tp-image-border }
+
+# Understanding the Application
+
+In this trading application, you can navigate through the main menu to check on 
+the different aspects of the traded products. These are commodity products. The 
+traded products, DEBMK22, FDBMK22, etc., represent 15 different types of a given 
+commodity.  
+
+## Market Forecast Panel
+
+The first screen is the "Market Forecast" panel. Here, one can visualize the 
+different trading recommendations made by the AI engine for commodity products. 
+Each box displays the AI engine forecast: Buy (Long) or Sell (Short) with an 
+attached confidence level. Note that the user can choose different products.
+
+![Market Forecast](images/market_forecast.png){width=90% : .tp-image-border }
+
+## Health Indicators
+
+This panel simply checks for each commodity if it trades in a normal range, if 
+the volatility index is high, etc.
+
+![Health Indicators](images/health_indicators.png){width=90% : .tp-image-border }
+
+### Detailed Health Indicators
+
+This panel provides a more precise view of some key indicators like CHI2 
+indicators.
+
+
+### Health Indicators (HI) Evolution
+
+Display the evolution the HI values over a time period.
+
+## Feature Accuracies
+
+The ML forecasting engine uses many features, which are also grouped by Type. 
+For instance, the COAL_FLOW feature group combines many COAL_FLOW features. 
+This panel displays:
+
+- the accuracies of the trading algorithm over different horizons - See the 3 
+SUCCESS columns.
+- the gains generated over different horizons - See the 3 GAIN columns.
+
+![Feature Accuracies](images/feature_accuracies.png){width=90% : .tp-image-border }
+
+
+## Group Contributions
+
+Two types of charts are displayed.
+
+![Feature Contribution](images/feature_contribution.png){width=90% : .tp-image-border }
+
+### The Waterfall Chart
+
+This panel is interesting as it shows which feature group has the most 
+significant positive impact (in green) or biggest negative impact (in red) on 
+the price of the selected commodity.
+
+![Waterfall Chart](images/waterfall_chart.png){width=70% : .tp-image-border }
+
+
+Note that different products or dates can be selected.
+
+You can move your mouse over each box to get more information:
+
+![Waterfall Chart Annotated](images/waterfall_chart_annotated.png){width=70% : .tp-image-border }
+
+Do note that when you click on a given red or green box, you immediately get 
+access to the same chart for each feature of the selected feature group. This 
+provides a detailed understanding of the impact of each feature within each 
+feature group. For instance, by clicking on the COAL_FLOW red box, the following 
+chart with all the individual features of the COAL_FLOW group is displayed.
+
+![Waterfall Chart for Coal Flow](images/waterfall_chart_coal_flow.png){width=70% : .tp-image-border }
+
+
+## Feature Ranking
+
+This chart visualizes the evolution of the ranking of each feature over time.
+
+![Feature Contribution](images/feature_contribution.png){width=90% : .tp-image-border }
+
+
+## Model Explainability
+
+This interesting panel displays three dimensions in a single graph: the feature 
+value, its contribution to the forecast, and whether the trade direction was 
+correct. You want to see a high contribution with high value, leading to a 
+successful prediction. This is an example of good "behavior" below.
+
+![Model Explainability](images/model_explainability.png){width=90% : .tp-image-border }

docs/gallery/finance/fraud_detection/index.md

@@ -14,7 +14,7 @@ A Taipy Application that analyzes credit card transactions to detect fraud.
     application. If you’re looking for solutions that are immediately deployable and customizable to 
     your business needs, we invite you to try them out and contact us for more detailed information.
 
-    [Try it live](https://fraud-detection.taipy.cloud/Transactions?null=){: .tp-btn target='blank' }
+    [Try it live](https://fraud-detection.taipy.cloud/Transactions){: .tp-btn target='blank' }
     [Contact us](https://taipy.io/book-a-call){: .tp-btn .tp-btn--accent target='blank' }
 
 

mkdocs.yml_template

@@ -224,6 +224,7 @@ nav:
       - "Finance": gallery/finance/index.md
       - "Stock Visualization": gallery/finance/1_stock_visualization/index.md
       - "Sales Dashboard": gallery/finance/4_sales_dashboard/index.md
+      - "Commodity Trading": gallery/finance/commodity_trading/index.md
       - "Fraud Detection": gallery/finance/fraud_detection/index.md
     - "Decision Support":
       - "Decision Support": gallery/decision_support/index.md