Skip to content

Commit

Permalink
.
Browse files Browse the repository at this point in the history
  • Loading branch information
Martin Rätz committed May 10, 2024
1 parent 1de6c8f commit 273c197
Show file tree
Hide file tree
Showing 4 changed files with 38 additions and 27 deletions.
Binary file modified Joss_Paper/Overview_WeatherTool.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
65 changes: 38 additions & 27 deletions Joss_Paper/paper.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,12 @@ authors:
- name: Martin Rätz
orcid: 0000-0002-3573-2872
affiliation: 1
- name: Rita Streblow
orcid: 0000-0001-7640-0930
affiliation: 1
- name: Dirk Müller
orcid: 0000-0002-6106-6607
affiliation: 1
affiliations:
- name: Institute for Energy Efficient Buildings and Indoor Climate, E.ON Energy Research Center, RWTH Aachen University, Germany
index: 1
Expand All @@ -23,55 +29,38 @@ bibliography: paper.bib
AixWeather is a tool for generating weather data for building energy system simulations.
It can be used to retrieve, format, enrich and ultimately export weather data in various file formats,
including .epw (EnergyPlus) and .mos (AixLib).
It addresses the challenges researchers and industry players face in obtaining accurate and standardized weather
data by providing a streamlined process.
It addresses the challenges researchers and industry players face in obtaining accurate and
formatted weather data by providing a streamlined process.

**Key features of AixWeather**:

*Data retrieval*: AixWeather can directly retrieve data from the german weather provider DWD, and
*Data retrieval*: AixWeather can directly retrieve data from the German weather provider DWD, and
supports historical, recent and forecasted weather data retrieval. It also supports the upload
of test reference years (TRY) from the DWD and .epw files from EnergyPlus. A custom weather data
upload is also supported, which depending on the data structure, needs to be adjusted by the user.

*Data conversion*: AixWeather converts this raw weather data from various sources into a
standardized
core format and from there into the desired export format.
defined core format and from there into the desired export format.

*Data accuracy*: AixWeather ensures data accuracy by taking into account critical factors that are
often overlooked in custom solutions, including consideration of time zones,
the time reference of the measurement, unit conversions, correct handling of incomplete data series
and, where possible, the avoidance of interpolation-related smoothing.

*Data enrichment*: AixWeather uses physical relationships to calculate missing weather variables
from the available weather data and metadata.
from the available weather- and metadata.

*Flexibility*: AixWeather offers a modular structure that simplifies the addition of new import and
output formats. The maintenance of existing formats is also simplified,
enabling a faster response to changing weather data formats.
output formats, and the maintenance of existing formats.

*Modelica ReaderTMY3 compatibility*: A special feature of AixWeather is its support for generating
weather data compatible with the Modelica ReaderTMY3 format. This covers a so far unsatisfied need.

AixWeather can be accessed through the repository itself, or through the web application at
https://aixweather.eonerc.rwth-aachen.de.
The web application is also open source and hosted in a separate repository at
https://github.com/RWTH-EBC/AixWeather-WebApp.
The web application provides a user-friendly interface
for even more convenient generation of weather data without the need of setting up an environment.

AixWeather empowers researchers and professionals working in building energy systems by streamlining
the weather data generation process. It ensures the availability of high-quality weather data,
enabling researchers to focus on their essential work in the field of building energy systems.

Figure \autoref{fig:AixWeatherStructure} shows the current structure of AixWeather.
Starting from the import layer, the data is transformed into a core format, and from there into the
desired export format. The core format is a standardized format that allows for easy conversion to
different export formats. The pass-through handling avoids avoidable interpolation-related
smoothing, through storing the original unsmoothed time series and, if the shifting sequence
allows, overwriting the smoothed time series in the output file.
[//]: # (AixWeather empowers researchers and professionals working in building energy systems by streamlining )

![Structure of AixWeather.\label{fig:AixWeatherStructure}](Overview_WeatherTool.png)
[//]: # (the weather data generation process. It ensures the availability of high-quality weather data, )

[//]: # (enabling researchers to focus on their essential work in the field of building energy systems.)

# Statement of need

Expand All @@ -87,7 +76,7 @@ EnergyPlus [@EnergyPlus.2017], a widely used building energy simulation tool, al
weather data converter to cover the needs of its users, again only supporting the .epw format.
There exist only limited tools for importing and converting real, historic or forecast, weather
data to building energy simulation formats.
The same holds true for Test Reference Years (TRY) from the german weather service (DWD).
The same holds true for Test Reference Years (TRY) from the German weather service (DWD).
Also, there is a lack of tools supporting conversions to the ReaderTMY3 format.
The ReaderTMY3 is a modelica model of the well established open source library Buildings
[@WetterZuoNouiduiPang.2014].
Expand All @@ -98,6 +87,28 @@ time to convert their weather data to the required format.
Solving this problem, was the initial motivation to develop AixWeather.
Now AixWeather also covers the aforementioned needs, making
it a valuable tool not only for researchers that work with the ReaderTMY3 format.
AixWeather is used by users of the open source library AixLib on a regular basis. Due to the
recent open source release and the lack of a citable reference, there is no citation yet.

# Accessibility

AixWeather can be accessed through the repository itself, e.g. to incorporated in simulation
automation workflows.
For manual weather data generation we recommend our locally hosted web application at
https://aixweather.eonerc.rwth-aachen.de, omitting the need to set up an environment.
The web application's source code is open source and hosted in a separate repository at
https://github.com/RWTH-EBC/AixWeather-WebApp.

# Structure of AixWeather

Figure \autoref{fig:AixWeatherStructure} shows the current structure of AixWeather.
Starting from the import layer, the data is transformed into a core format, and from there into the
desired export format. The core format is a defined format that allows for easy conversion to
different export formats. The pass-through handling avoids avoidable interpolation-related
smoothing, through storing the original unsmoothed time series and, if the shift sequence
allows, overwriting the smoothed time series in the output file.

![Structure of AixWeather.\label{fig:AixWeatherStructure}](Overview_WeatherTool.png)****

# Acknowledgements

Expand Down
Binary file added docs/.$Overview_WeatherTool.png.bkp
Binary file not shown.
Binary file modified docs/Overview_WeatherTool.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 273c197

Please sign in to comment.