Actions

NCPOLO: Difference between revisions

From BAWiki

(Created page with "{{ProgramDescription |name_de=NCPOLO |name=NCPOLO |version=August 2019 |version_descr=April 2020 |catchwords=Postprocessor<br /> time series<br /> hodograph<br /> scatterplots...")
 
(working group POS)
 
(3 intermediate revisions by 2 users not shown)
Line 3: Line 3:
|name=NCPOLO
|name=NCPOLO
|version=August 2019
|version=August 2019
|version_descr=April 2020
|version_descr=September 2022
|catchwords=Postprocessor<br />
|catchwords=Postprocessor<br />
time series<br />
time series<br />
Line 12: Line 12:
|shortdescription=
|shortdescription=
[[NCPOLO]] is applied in model calibration and validation. It corroborates validation illustration and skill scores combined with various export possibilities. With [[NCPOLO]], a observation-prediction comparison can be performed quickly. For a successful application of [[NCPOLO]], all measurements and model data must be available in pooled [[CF-NETCDF.NC|cf-netcdf.nc]] data. A time and space correlated difference, which can be interpreted by [[NCPOLO]] must be created with [[NCDELTA]].
[[NCPOLO]] is applied in model calibration and validation. It corroborates validation illustration and skill scores combined with various export possibilities. With [[NCPOLO]], a observation-prediction comparison can be performed quickly. For a successful application of [[NCPOLO]], all measurements and model data must be available in pooled [[CF-NETCDF.NC|cf-netcdf.nc]] data. A time and space correlated difference, which can be interpreted by [[NCPOLO]] must be created with [[NCDELTA]].


Remarks:
Remarks:
Line 23: Line 24:
* The processing of chunked data is usually faster, when using [[NCDELTA]]. One can chunk a  [[CF-NETCDF.NC|cf-netcdf.nc]] file using [[NCCHUNKIE]].
* The processing of chunked data is usually faster, when using [[NCDELTA]]. One can chunk a  [[CF-NETCDF.NC|cf-netcdf.nc]] file using [[NCCHUNKIE]].
* As the output can be defined in multiple languages, with more than 5 detailed times per tide gauge, the output mass can grow quickly to more than 1,000. Therefore, a user should only enable the illustrations, which are absolutely required.
* As the output can be defined in multiple languages, with more than 5 detailed times per tide gauge, the output mass can grow quickly to more than 1,000. Therefore, a user should only enable the illustrations, which are absolutely required.


Output of [[NCPOLO]]:
Output of [[NCPOLO]]:
Line 32: Line 34:
* data export (per gauge)
* data export (per gauge)
* statistics export (per gauge, all gauges)
* statistics export (per gauge, all gauges)
|Remarks=
# The measurements must be in the format [[BOEWRT.DAT]] and end with *.boewrt.dat
# It is highly recommeded to quality control the data before converting it, as it is rather complicated to adjust values in [[CF-NETCDF.NC|cf-netcdf.nc]] data afterwards.
# If more than one depth value per station is available (e. g. 2 different heights for measurements of salinity), the station name should be changed to for example station_top and station_bottom. Both stations still need an individual water level time series!


|inputfiles=
|inputfiles=
# req: steering[[BOE2NC.DAT]]
* req: steering[[NCPOLO.DAT]]
# opt: order of station e. g. order.txt


|outputfiles=   
|outputfiles=   
# log (Dateityp *.sdr)
* (req) log (type *.sdr)
# errors and warnings (Dateityp *.err)
* (req) errors and warnings (type *.err)
# folder boewrt: original data
* (req) time series (type PNG, FIG, EPS, FIG)
# folder boe: data as homogenized by [[ZEITRIO]]
* (opt) scatter plot (type PNG, FIG, EPS, FIG)
# folder nc: data as homogenized by [[ZEITRIO]], converted by [[DATACONVERT]] and appended by ncks
* (opt) hodograph (type PNG, FIG, EPS, FIG)
# folder nc_cat: ncrcat -h of the data in nc
* (opt) box-whisker plots (type PNG, FIG, EPS, FIG)
* (opt) statistic distribution (type PNG, FIG, EPS, FIG)
* (opt) statistic parameters (type DAT, CSV, LATEX)
* (opt) comparison data (type DAT, CSV, MAT)
* (opt) statistic overview (type DAT, CSV, MAT)
 
|methodology=
This program was created with [[MATLAB]] and [[PROGHOME]] methods.


|preprocessor=[[DATACONVERT]], [[ZEITRIO]]
|preprocessor=[[NCDELTA]], [[NCDVAR]], [[NCMERGE]]
|postprocessor=[[NCANALYSE]], [[NCDVAR]], [[NCPOLO]], [[NCPLOT]], [[NCVIEW2D]], [[NetCDF Operators]]
|postprocessor=[[MATLAB]]
|language=MATLAB r2019b
|language=MATLAB r2019a
|add_software= keine
|add_software= keine
|contact_original=[mailto:robert.hagen@baw.de R. Hagen]
|contact_original=R. Hagen
|contact_maintenance=[mailto:robert.hagen@baw.de R. Hagen]
|contact_maintenance=[mailto:pos.proghome@baw.de Working group POS] and R. Hagen
|documentation=
|documentation=
* Template Files:
* Template Files:
** template files available in '''$PROGHOME/examples/boe2nc/'''
** template files available in '''$PROGHOME/examples/ncpolo/'''
}}
}}

Latest revision as of 10:47, 6 September 2022

Basic Information

Name of Program

NCPOLO

Version-Date

August 2019

Description-Date

September 2022

Catchwords

Postprocessor
time series
hodograph
scatterplots
model skill

Short Description of Functionality

NCPOLO is applied in model calibration and validation. It corroborates validation illustration and skill scores combined with various export possibilities. With NCPOLO, a observation-prediction comparison can be performed quickly. For a successful application of NCPOLO, all measurements and model data must be available in pooled cf-netcdf.nc data. A time and space correlated difference, which can be interpreted by NCPOLO must be created with NCDELTA.


Remarks:

  • One should use BOE2NC for the preprocessing of non-pooled BOEWRT.DAT data
  • Measurements should be checked, as NCPOLO does not perform any plausibility checks on input data
  • Measurement names must be one-of-a-kind, as more than one measurement (e. g. multiple depths) are not possible to interpret yet.
  • Stations are named from the long_name of the NCDELTA variant
  • Model data can be provided in 2d and 3d
  • NCDELTA must be run with with_original_data = .true.
  • The station name will be used troughout illustrations and skill scores. Thus it is smart to chose a short name.
  • The processing of chunked data is usually faster, when using NCDELTA. One can chunk a cf-netcdf.nc file using NCCHUNKIE.
  • As the output can be defined in multiple languages, with more than 5 detailed times per tide gauge, the output mass can grow quickly to more than 1,000. Therefore, a user should only enable the illustrations, which are absolutely required.


Output of NCPOLO:

  • time series (complete, parts)
  • scatter plots (colored by density, uniform)
  • hodographs of current (colored by density, uniform)
  • box-whisker error distribution
  • statistics (33 parameters)
  • data export (per gauge)
  • statistics export (per gauge, all gauges)

Input-Files

Output-Files

  • (req) log (type *.sdr)
  • (req) errors and warnings (type *.err)
  • (req) time series (type PNG, FIG, EPS, FIG)
  • (opt) scatter plot (type PNG, FIG, EPS, FIG)
  • (opt) hodograph (type PNG, FIG, EPS, FIG)
  • (opt) box-whisker plots (type PNG, FIG, EPS, FIG)
  • (opt) statistic distribution (type PNG, FIG, EPS, FIG)
  • (opt) statistic parameters (type DAT, CSV, LATEX)
  • (opt) comparison data (type DAT, CSV, MAT)
  • (opt) statistic overview (type DAT, CSV, MAT)

Methodology

This program was created with MATLAB and PROGHOME methods.

Program(s) to run before this Program

NCDELTA, NCDVAR, NCMERGE

Program(s) to run after this Program

MATLAB

Additional Information

Language

MATLAB r2019a

Additional software

keine

Original Version

R. Hagen

Maintenance

Working group POS and R. Hagen

Documentation/Literature

  • Template Files:
    • template files available in $PROGHOME/examples/ncpolo/

back to Program Descriptions

Overview

Retrieved from "http://wiki.baw.de/en/index.php?title=NCPOLO&oldid=14893"