Download

To run ‘Future Weather Generator,’ you must have the latest version of Java installed. After installing it, you may run it by double-clicking on its icon. In Windows machines, you may need to right-click it and select ‘Open With’. Then, select Java Virtual Machine Launcher.

For any questions, please contact helpdesk.fwg@adai.pt.

CMIP6 Global

CORDEX-CMIP5 Regions

WRF-CMIP6 Country

Version logs

All Future Weather Generator distributions now share the same engine and graphical interface (Engine v1.0.0), except for Portugal, which uses a legacy interface. This new architecture allows better maintenance and cross-distribution with similar implementations. Overall, the main advance is the transition from the comparatively monolithic application to a modular, edition-independent, scientifically auditable, and reproducible engine.

· Shared engine and edition architecture: one Java engine supports separately packaged climate distributions—such as CMIP6 Global and CORDEX-CMIP5 regional editions—through manifests and edition-specific resources rather than separate codebases. Engine, distribution, dataset, and generator versions are tracked independently.

· Stronger EPW processing: transactional reading/writing, typed field access, immutable validated baselines, and a normalized Local Standard Time axis that correctly handles leap years, subhourly data, partial files, and nonstandard record counts.

· Integrated EPW SolarQC workflow: the baseline weather file is validated and, where justified, corrected before morphing; multiple solar-decomposition and illuminance models are available, with record-level flags and independent scientific-assessment outputs.

· More rigorous morphing pipeline: climate transformations now use a common processing architecture with cyclic monthly transitions, dependency-aware recalculation of derived variables, and automatic physical-consistency checks.

· Explicit uncertainty analysis: users can generate central, ±1 standard deviation, warm–dry, warm–humid, high-solar, and low-solar sensitivity cases. These are documented deterministic boundary cases, not probabilistic confidence intervals.

· Improved reproducibility and provenance: every scenario can include monthly applied climate signals, method settings, model membership, checksums, machine-readable manifests, and a linked HTML audit report.

· Modernized interface and automation: clearer quick and advanced workflows, GUI/CLI selection of morphing and uncertainty methods, portable tests, deterministic builds, and automated quality gates.

Source code

The source code of the app can be found in the Bitbucket repository:

'Future Weather Generator'
https://bitbucket.org/cling-project/futureweathergenerator

'Future Weather Generator PT Ed.' (Portugal)
https://bitbucket.org/cling-project/futureweathergenerator_portugal

Publication

If you use our software, please consider citing our software and our publication:

Rodrigues E, Fernandes MS, Carvalho D, Future weather generator for building performance research: An open-source morphing tool and an application. Building and Environment, 2023; 233:110104. doi:10.1016/j.buildenv.2023.110104.

Disclaimer

The software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise,arising from, out of or in connection with the software or the use or other dealings in the software.

Licensing

'Future Weather Generator' by Eugénio Rodrigues, David Carvalho, and Marco S. Fernandes is licensed under CC BY-NC-SA (Creative Commons Attribution 4.0 Share Alike license).

CC BY-NC-SA: This license allows reusers to distribute, remix, adapt, and build upon the material in any medium or format for noncommercial purposes only, and only so long as attribution is given to the creator. If you remix, adapt, or build upon the material, you must license the modified material under identical terms.

Contributing

Reporting issues

Before reporting issues, please update to the latest ‘Future Weather Generator’ version. If the issue persists, check if the bug was already reported in the Bitbucket repository. If the issue has not yet been reported, please provide the following information:

• Operating system
• Java version
• The version of the ‘Future Weather Generator’
• Description of the issue
• Provide all the data needed to reproduce the problem

Suggesting enhancements

Before suggesting an enhancement, please confirm that the proposed enhancement is not already implemented. If such enhancement has not yet been implemented, provide us with a detailed description and include as many details as possible by creating an issue in the Bitbucket repository. Fill in the following template:

• Summary of the enhancement
• Motivation
• Describe alternatives
• Additional context

Code of conduct

The ‘Future Weather Generator’ community comprises a mixture of researchers and volunteers from all over the world, working on every aspect of the distribution, from coding to marketing. Diversity is one of our enormous strengths but can lead to communication issues and unhappiness. To that end, we have a few ground rules that we ask people to adhere to when they’re using project resources. This code of conduct isn’t an exhaustive list of things you can’t do. Instead, take it in the spirit it’s intended – a guide to make it easier to be excellent to each other.

• Be considerate. Other people will use your work, and you, in turn, will depend on the work of others. Therefore, any decision you take will affect users and colleagues, and you should consider those consequences when making decisions.
• Be respectful. Not all of us will always agree, but disagreement is no excuse for poor behavior and manners. We might all experience some frustration now and then. Still, we cannot allow that frustration to become personal attacks. It’s important to remember that a community where people feel uncomfortable or threatened is not productive. Members of the ‘Future Weather Generator’ community should be respectful when dealing with other contributors and people outside the ‘Future Weather Generator’ community and with users of ‘Future Weather Generator.’

When we disagree, we try to understand why. Social and technical disagreements happen all the time, and ‘Future Weather Generator’ is no exception. We must resolve disagreements and differing views constructively. Remember that we’re different. The strength of ‘Future Weather Generator’ comes from its varied community, people from various backgrounds. Different people have different perspectives on issues. Being unable to understand why someone holds a viewpoint doesn’t mean they’re wrong. Don’t forget that it is human to err. Therefore, blaming each other doesn’t get us anywhere. Rather, we offer to help resolve issues and learn from mistakes.

Credits for the sources and inspiration of this Code of Conduct go to the Fedora Project.

Authors

For those who wish to contribute to the app development, you may report issues in the source code webpage or even ask to be part of the developing team.

Third-party tools

• pyfwg – Daniel Sánchez-García’s python wrapper for Future Weather Generator (GitHub and Documentation). It is a robust, step-by-step Python workflow manager.