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...")
 
No edit summary
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)


|preprocessor=[[DATACONVERT]], [[ZEITRIO]]
|preprocessor=[[NCDELTA]]
|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=[mailto:robert.hagen@baw.de R. Hagen]
Line 58: Line 58:
|documentation=
|documentation=
* Template Files:
* Template Files:
** template files available in '''$PROGHOME/examples/boe2nc/'''
** template files available in '''$PROGHOME/examples/ncpolo/'''
}}
}}

Revision as of 10:17, 16 April 2020

Basic Information

Name of Program

NCPOLO

Version-Date

August 2019

Description-Date

April 2020

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

{{{methodology}}}

Program(s) to run before this Program

NCDELTA

Program(s) to run after this Program

MATLAB

Additional Information

Language

MATLAB r2019a

Additional software

keine

Original Version

R. Hagen

Maintenance

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=14352"