There is a newer version of this record available.

Software Open Access

metno/pyaerocom: Release version 0.8.0

Jonas; Jan Griesfeller; Hanna Svennevik

Citation Style Language JSON Export

  "publisher": "Zenodo", 
  "DOI": "10.5281/zenodo.4159570", 
  "title": "metno/pyaerocom: Release version 0.8.0", 
  "issued": {
    "date-parts": [
  "abstract": "<p>Published here with one year delay, for completeness.</p>\n<p>This release comprises major improvements, changes and many new features compared to the last release (comprising about 10 months of development time). Thus, below we only summarise the most important changes. For a list of all changes, please see the changelog file of this release (in subdirectory changelog).</p>\n<ul>\n<li><p>New sub-package <code>web</code> (tools for high-level web processing)</p>\n<ul>\n<li>Contains frameworks and routines for high level analysis of data and computation of json files both for AeroCom evaluation and trends web interfaces.</li>\n<li>Includes 2 simple command line interfaces <em>pyaeroeval</em> and <em>pyaerotrends</em> for web processing</li>\n<li>Main classes:<ul>\n<li><code>AerocomEvaluation</code> for processing of data displayed at <a href=\"\"></a></li>\n<li><code>TrendsEvaluation</code> for data displayed at <a href=\"\"></a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li><p>Gridded reading (<code>ReadGridded</code> class and methods used therein)</p>\n<ul>\n<li><code>data_dir</code> can be provided directly on input in <code>ReadGridded</code> (e.g. for working locally with no database access). However, data files are required to be in AeroCom naming convention.</li>\n<li>og550gtaer is now primarily computed via od550aer-od550lt1aer</li>\n<li>easy file filtering for all attributes accessible via filename (e.g. model, variable, year, vertical type)</li>\n<li>option to compute variables during runtime for custom methods</li>\n<li>Clean up of outdated methods</li>\n<li>improved logic of processing work-flow, especially for computation of variables and handling of 4D files, e.g.<ul>\n<li>use ModelLevel files if Surface is requested but not available</li>\n<li>Compute mass concentration fields (<code>concXX</code>) from mass mixing ratios (<code>mmrXX</code>) and density (<code>rho</code>) fields</li>\n</ul>\n</li>\n<li>Reading of climatological data (i.e. year 9999 in filename). Remark: tricky, because pandas cannot handle timestamps with year 9999  </li>\n<li>More flexible options for reading of iris cubes (<code></code>)</li>\n<li>Improved check and correction of invalid time dimensions in source files</li>\n</ul>\n</li>\n<li><p>Ungridded reading (Reading of observations)</p>\n<ul>\n<li>EBAS: implemented framekwork for computation of variables from variables that can be read (or computed)</li>\n<li>EBAS: evaluate and use flag columns (flagged data added to new flag column in <code>UngriddedData</code> object)</li>\n<li>EBAS: support all occurring sampling frequencies (e.g. weekly, 2daily, etc.)</li>\n<li>EBAS: default now reads raw (i.e. as is in NASA Ames files), but writes all relevant information for filtering (e.g. datalevel, flags) into output <code>UngriddedData</code> object, which can then be filtered flexibly after reading</li>\n<li>New reading routine for GAW ascii format</li>\n<li>New reading routine for data subset from trends paper by Aas et al.</li>\n<li>Updated EARLINET reading routine after major changes in format (Feb. 2019)</li>\n<li>More flexible handling of cached data objects in <code>ReadUngridded</code> (cf. changes in caching strategy below)</li>\n</ul>\n</li>\n<li><p>Data classes</p>\n<ul>\n<li><p><code>StationData</code></p>\n<ul>\n<li>Merging of multiple instances possible (including metadata merging and handling of overlapping data)</li>\n<li>Removed attrs. stat_lon, stat_lat, stat_alt</li>\n<li>Support trends computation and visualisation</li>\n<li>Support profile data</li>\n</ul>\n</li>\n<li><p><code>UngriddedData</code></p>\n<ul>\n<li>Support for flags and error data</li>\n<li>Outlier removal</li>\n<li>More flexible and robust conversion into StationData</li>\n<li>More advanced filtering and subsetting (e.g. extract single variable)</li>\n<li>Methods for merging of several instances</li>\n<li>Added <strong>iter</strong> method (looping over data object -&gt; returns StationData at each index, BETA)</li>\n</ul>\n</li>\n<li><p><code>GriddedData</code></p>\n<ul>\n<li>More flexible subsetting (e.g. sel method)</li>\n<li>Method to automatically infer surface level for 3D data</li>\n<li>Cleaned up attributes: now everything is stored within underlying cube (i.e. attr. <code>suppl_info</code> is deperecated)</li>\n<li>Added CF attributes such as <code>standard_name</code> and <code>long_name</code></li>\n<li>WORK IN PROGRESS: altitude access for 4D fields via <code>get_altitude</code> method (cleaned up and refactored old code due to below mentioned updates in mod <code></code>)</li>\n<li>option to add metadata when converting to timeseries (<code>StationData</code>) at distinct locations</li>\n</ul>\n</li>\n<li><p><code>ColocatedData</code></p>\n<ul>\n<li>Updated I/O and naming conventions</li>\n<li>Region filtering</li>\n<li>time resampling</li>\n</ul>\n</li>\n<li>All data classes contain many more helper and analysis methods and attributes, that are not explicitely mentioned here, for details see changelog</li>\n</ul>\n</li>\n<li><p>Colocation: Improved flexibility and robustness of colocation routines (modules <code></code>, <code></code>), e.g.</p>\n<ul>\n<li>more control on individual outlier removal for both input datasets</li>\n<li>hierarchical resampling</li>\n<li>option for outlier removal</li>\n<li>option for unit harmonisation</li>\n<li>option for colocating time before downsampling</li>\n<li>option to ignore certain station names (for gridded / ungridded colocation)</li>\n<li>colocation with climatology data</li>\n<li>High level interface (<code>Colocator</code> class) for automatic colocation, e.g. used in <code>AerocomEvaluation</code> class for web processing.</li>\n</ul>\n</li>\n<li><p>Other changes:</p>\n<ul>\n<li>Updated method <code>calc_statistics</code>: biases (NMB, MNMB) and FGE are now computed only from positive values</li>\n<li>New modules <code></code> providing custom unit conversion, e.g. for non-CF conform units in data files (e.g. sulphur specific mass concentration data: ug S m-3)</li>\n<li>Improved caching stragegy (now single variable instances of <code>UngriddedData</code> are cached)</li>\n<li>Easier installation options</li>\n<li>Support for simple geographical calculations</li>\n<li>New helpers and processing methods in <code></code></li>\n<li>Support for more variables</li>\n<li>Advanced and unified time resampling in <code>TimeResampler</code> class</li>\n<li>More CF-compliant (e.g. <code>units</code> attr. in data classes)</li>\n<li>More flexible and unified handling (and sharing) of metadata among different data objects</li>\n<li>Methods for trends computation (class <code>TrendsEngine</code>)</li>\n<li>Major improvements in ungridded caching using single variable cache files for I/O</li>\n<li>Bug fixes</li>\n<li>New class <code>TsType</code> for handling and comparing temporal resolutions (in new mod <code></code>)</li>\n<li>More flexible tests (using pytest markers that check access to database)</li>\n<li>Worked on implementation of vertical coordinate to altitude conversion methods (WORK IN PROGRESS, mod. <code></code>)</li>\n</ul>\n</li>\n<li><p>API changes:</p>\n<ul>\n<li><code>Station</code> class is deprecated</li>\n<li><code>ReadGriddedMulti</code> is deprecated (but still works)</li>\n<li>sconc variables are deprecated (but still work): use conc instead (e.g. concso4 instead of sconcso4)</li>\n<li>Renaming of classes / modules:<ul>\n<li><code>AllVariables</code> to <code>VarCollection</code></li>\n<li><code>unit</code> to <code>units</code></li>\n<li>Moved <code>GridIO</code> class from <code></code> to dedicated new module <code></code></li>\n<li>Global setup dictionaries for time conversion moved from <code></code> to <code></code></li>\n</ul>\n</li>\n</ul>\n</li>\n<li><p>Not finished / under development / coming soon</p>\n<ul>\n<li>Handling of vertical model coordinates</li>\n<li>Colocation of profile data</li>\n<li>Filtering by land / sea masks</li>\n<li>Computation of regional average time series in data objects</li>\n</ul>\n</li>\n<li><p>Planned major changes for v0.9.0:</p>\n<ul>\n<li>API refactor: StationData based on xarray.Dataset (currently variable data can be either numpy array, pandas Series or xarray)</li>\n<li>Include filtering using land / sea masks (should work for <code>GriddedData</code>, <code>UngriddedData</code>, <code>ColocatedData</code>)</li>\n<li>4D data (ModelLevel):<ul>\n<li>conversion of vertical level coordinates to altitude</li>\n<li>profile colocation (would add additional vertical dimension to <code>Colocateddata</code>)</li>\n<li>Retrieval of aerosol layer height (PRODUCT)</li>\n<li>Default vertical domains for vertical aggregation (particularly for web interfaces, e.g. 0-2km, 2-6km, &gt;6km)</li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>", 
  "author": [
      "family": "Jonas"
      "family": "Jan Griesfeller"
      "family": "Hanna Svennevik"
  "version": "v0.8.0", 
  "type": "article", 
  "id": "4159570"
All versions This version
Views 11330
Downloads 60
Data volume 7.8 MB0 Bytes
Unique views 8626
Unique downloads 60


Cite as