How dedo99/infovis_individual_project_de_donato works
Project type and purpose
• This is a client-side, single-page information-visualization web application.
File structure
• Top-level files:
• README.md – project description
• index.html – entry point
• Directories under hot_air_balloon:
• data/dataset.json – source data
• lib/d3.v6.js – D3 visualization library
• script/script.js – custom visualization logic, data loading, event handling, animations
• style/style.css – CSS for layout and styling
• figures, images – assets, e.g., silhouettes (if any)
• No backend directory or server-side code: purely static frontend.
README for additional insights
• Requires D3 scales for mapping arbitrary data ranges to screen coordinates and sizes.
Main components and their relationships
a. Components
• Static File Server (any simple HTTP server or local filesystem)
• Browser (runtime environment)
• index.html (shell for the page)
• CSS (style/style.css)
• D3 library (lib/d3.v6.js)
• Application script (script/script.js)
• Dataset (data/dataset.json)
• Optional assets (hot_air_balloon/images, figures)
b. Relationships / data flow
1. Browser requests index.html from the server.
2. index.html loads style.css, d3.v6.js, script.js.
3. script.js issues an HTTP GET to load dataset.json.
5. script.js (with D3) constructs SVG or HTML elements for balloons and baskets in the DOM.
6. User clicks on balloons → script.js updates data model → D3 performs animated transitions on the SVG attributes.
c. Architectural patterns/design principles
• Separation of concerns: HTML for structure, CSS for styling, JS for behavior.
• Data-Driven Documents (D3): declarative data binding, enter/update/exit pattern.
• Event-driven UI: click events trigger data swaps and animations.
d. Key technologies/frameworks/libraries
• D3.js v6 for scales, selections, transitions
• JavaScript for DOM manipulation and event logic
• JSON for data serialization
• HTML5/CSS3 for presentation
Final recommendations
• Be extremely detailed: break the client-side into “data layer”, “visualization layer”, “presentation layer”, and “interaction layer.”