What is WeaCoDi?
Weacodi is an alternative way to visualize the weather forecast, allowing you to assess atmospheric conditions in one second. Instead of complex numerical values, Weacodi uses an intuitive diagram to quickly convey how comfortable or uncomfortable the weather will be. This unique approach allows you to understand at a glance whether you should, for example, plan a walk or a workout.
Weacodi is based on the principles of human cognitive perception of weather conditions and multimodality. This approach uses various sensory channels for a more complete and intuitive understanding of the weather.
You can dive deeper into the concept in the documentation section.
Weacodi displays various weather parameters, such as:
- Sky condition (sunny, cloudy)
- Precipitation (rain, snow)
- Comfort level (calculated based on weather conditions)
This allows you to quickly "feel" the weather without spending time analyzing complex data.
Weather Comfort Diagram (weacodi), illustrates the weather forecast. The diagram is simple to read and doesn’t require any specific units of measurement, offering a clear and intuitive overview of the weather conditions in no time.
This visualization method was developed by Oleksii Zubovskyi and Olena Zubovska during the development of Android weather forecast application for cyclists, Cycling Weather. The Cycling Weather app provides detailed weather forecasts and personalized clothing suggestions tailored for cyclists. It utilizes the Weacodi diagram to offer a clear and intuitive overview of weather conditions, helping cyclists quickly assess the comfort level for their rides.
Weather Comfort Diagram
Short name: Weacodi™, phonetic transcription: /wiːˈækədi/.
Ease of Perception: The main goal of the diagram is to provide the user with weather information without the need to read numerical values, which significantly simplifies decision-making regarding training or trips.
Combination of Graphs: The diagram consists of a set of combined graphs, which allows integrating various weather data into a single image, making it easier for the user to perceive.
Absence of Numerical Values: The diagram does not use numerical values, making it intuitive and accessible for users without specialized training.
Relative Values: The values on the Y-axis are relative and help the user quickly understand how comfortable or dangerous the weather conditions are without delving into details. The diagram consists of a set of combined graphs that display various weather parameters throughout the day. The Y-axis of the diagram reflects relative values answering the question, "How much? Is it maximally possible or not at all?" This allows visualizing different aspects of the weather without the need for specific numerical values. The X-axis of the diagram reflects time.
Visual Representation of Weather Conditions: The diagram displays various weather parameters, including sky, sun, cloudiness, rain, snow, as well as the calculated comfort level, providing the user with a comprehensive view of the weather conditions.
The diagram displays the following data (see picture):
- Day – displayed depending on the time of day (1).
- Night – displayed depending on the time of day (black color area).
- Sun – the amount of sunlight, taking the time of day into account (2).
- Clouds – shows the presence and density of clouds, from a few clouds to a complete overcast (3).
- Rain – displays the presence of precipitation, including the probability and intensity of rain (4).
- Snow – displays the presence of snow, including the probability and intensity of snowfalls (5).
- Calculated comfort level (optional) – determined based on weather conditions, taking into account the time of year, showing comfort for cycling and training depending on the current conditions (6).
- Other relative values, for example, wind speed, where the maximum value "very windy" and minimum value "no wind at all" are relative and depend on the current application requirements.
Particular attention should be given to the line on the graph representing the "comfort level." This parameter is calculated using a unique algorithm that takes into account all weather data, including the sun, cloudiness, rain, and snow, as well as seasonal changes. The maximum comfort level means "very comfortable," the minimum means "absolutely uncomfortable, dangerous," and the average means "normal comfort level."
With this diagram, the user can instantly get an answer to the question: "Is the weather comfortable?" without the need to read numerical values. This simplifies the decision-making process of whether it’s worth going for a walk, training session or a ride.
Example Weacodi
We can see that it's currently night. Tomorrow will be a good day, though there will be no sunshine. Rain is expected overnight and will continue into the morning. The following day will bring both rain and snow. However, after that, a beautiful sunny day will follow.
Cycling Weather app
Below is an example of how Weacodi is embedded as a widget inside the Cycling Weather application.
Screenshot from the Cycling Weather app.
Learn more & downloadWeacodi Grafana Plugin
Official datasource + panel bundle for Grafana, powered by the Fastify API from this project.
Code licensed under AGPL‑3.0; the Weather Comfort Diagram concept remains under CC BY-SA 4.0.
Garmin Instinct 2 watch face
Below is an example of the monochrome Weacodi widget on Garmin Instinct 2.
Weacodi watch face for Garmin Instinct 2.
Documentation
The guide shows how to build and embed the Weather Comfort Diagram consistently in apps, dashboards, and print.
- Layout: time axis, relative scale, day/night bands, comfort level, core layers.
- Elements: sun/cloud, rain/snow, comfort line, other optional parameters.
- Styling: palette, typography, spacing, and general readability guidance.
- Usage examples: widget, wearable, and dashboard layouts.
- License reminders: how to attribute and keep derivatives under ShareAlike.
Download: weacodi-concept.pdf
License
CC BY-SA 4.0 essentials
Weather Comfort Diagram (Weacodi) is released under Creative Commons Attribution-ShareAlike 4.0. In practice this means:
- Use it: embed the diagram in dashboards, widgets, wearables, or any other project, commercial or personal.
- Credit it: mention Oleksii Zubovskyi and Olena Zubovska, link to https://weacodi.com, and name the concept “Weather Comfort Diagram” or “Weacodi”.
- Share alike: publish adaptations under CC BY-SA 4.0 (or a compatible ShareAlike license such as AGPL-3.0) so improvements remain open.
Trademark notice
Weacodi™ and any stylized variants are claimed as trademarks by Oleksii Zubovskyi and Olena Zubovska. Use the name descriptively, but do not brand your product, logo, or domain with it without permission. Questions? Email weacodi@gmail.com.
Legal and Usage Information
Weather Comfort Diagram is an original concept created by Oleksii Zubovskyi and Olena Zubovska. It turns detailed forecasts into an instant visual by highlighting light conditions, precipitation, and comfort bands.
The diagram is shared under CC BY-SA 4.0 (details in the License section above) so teams can adopt and extend it while keeping attribution intact. The implementation manual describes the chart structure, colour palette, and UX guidelines.
Trademark: Weacodi — a unique brand name
“Weacodi” is a made-up word, similar to how “Google” or “Spotify” represent distinctive brands. Use it freely in speech, documentation, dashboards, and “Powered by” labels, but do not convert it into your own product name or logo.
| Allowed | Not allowed |
|---|---|
| “Check the Weacodi forecast” | “Weacodi Weather App” |
| UI labels like “Weacodi comfort level” | Using Weacodi inside your logo |
| “Powered by Weacodi” badges | Registering domains that contain “weacodi” (e.g. weacodi.app, weacodi-forecast.com) |
| Docs/social posts referencing the concept | Claiming official endorsement |
Bottom line: use Weacodi freely in descriptive, referential, and conversational contexts — just don’t make it your brand.
Attribution examples
- App or dashboard footer:
My Weather Forecast
Weacodi concept | https://weacodi.com | CC BY-SA 4.0 - Powered-by badge: “powered by Weacodi” or “powered by Weacodi | weacodi.com”.
- README snippet:
## Weacodi Integration This plugin integrates Weacodi - an intuitive weather comfort diagram - into your stack. Original concept: weacodi.com Concept authors: Oleksii Zubovskyi & Olena Zubovska Concept license: CC BY-SA 4.0 Plugin license: AGPL-3.0 (compatible with ShareAlike) Plugin authors: [plugin author names] - Social post: “Just added Weacodi to my home dashboard — now I know if it’s rideable in 1 second! Based on the awesome concept from @weacodi: https://weacodi.com”.
Questions about integration or branding?
Need clarification about licensing, attribution, or trademark usage? Email weacodi@gmail.com.
Get in Touch
- weacodi@gmail.com
We are Oleksii Zubovskyi and Olena Zubovska, creators of the Weather Comfort Diagram. Originally developed for our own purposes, it is now shared openly so others can benefit as well. If you are using the diagram, need attribution details, or would like to collaborate, feel free to contact us at weacodi@gmail.com.
Warm regards,
Oleksii & Olena
