How ossian-malmborg/mnxb11-group3-project works
Project type and purpose
• This is a scientific data‐analysis and visualization pipeline written in C++ and ROOT macros.
• It ingests raw CSV weather data for multiple stations (Falun, Falsterbo, Uppsala), cleans and processes it via command‐line C++ tools, then generates physics‐style plots in the ROOT framework.
File structure
Top level:
• C++ cleaning & analysis sources:
• cleaning_data_*.cxx (data cleansing per city)
• FalunVSFalsterbo.cxx (compute temperature difference)
• warmest_coldest.cxx (determine warmest/coldest days per year)
• temperature_given_day.cxx (per‐day extractor)
• ROOT plotting macros:
• FalunVSFalsterboPlot.C
• warmest_plot.C / plot_results.C
• Data:
• datasets/*.csv (raw inputs)
• Documentation:
• README.md, workplan.md, changelog.txt, LICENSE
README insights
• Describes the two analysis workflows (“FalunVSFalsterbo” and “Warmest_Coldest”)
• Shows build/run commands (g++ compile → executable → CSV output → ROOT .L macro → plot function)
• No service‐oriented architecture or external APIs—pure batch pipeline.
a. Main components
1. Raw Data Store
• datasets/*.csv
2. Data Cleaning Modules
• cleaning_data_Falun.cxx → clean_Falun.csv
• cleaning_data_Falsterbo.cxx → clean_Falsterbo.csv
• cleaning_data_Uppsala.cxx → clean_Uppsala.csv
3. Analysis Modules
• FalunVSFalsterbo.cxx → diff.csv
• warmest_coldest.cxx → warmest_coldest.csv
• temperature_given_day.cxx (optional extractor)
4. Visualization / Plotting
• FalunVSFalsterboPlot.C → PlotTemperatureDifference()
• warmest_plot.C → plot_results()
5. Tooling
• g++ (compiler)
• ROOT (plotting framework)
b. Relationships & data flow
c. Architectural patterns & design principles
• Linear batch‐pipeline: discrete stages, file‐based handoff
• Single responsibility per module: each .cxx does one transformation
• Convention over configuration: compile/run naming conventions
• Separation of concerns: cleaning vs analysis vs visualization
d. Key technologies & frameworks
• C++17 (g++)
• ROOT (CERN’s data‐analysis & plotting library)
• UNIX shell (compile & execute commands)
• CSV files as intermediate exchange format
Detail
• Branching: both Falun and Falsterbo cleaning feed into FalunVSFalsterbo analysis.
• Optional tools like temperature_given_day.cxx as side utilities.