Skip to contents

Reads PALMA data files grouped by date exported in CSV format and returns a list with parsed metadata/data.

Usage

read_palma_export(
  datafile. = NULL,
  echo. = NULL,
  checkit. = NULL,
  longc. = NULL,
  timeformat. = NULL,
  maxLines. = NULL
)

Arguments

datafile.

file to read, string complete with path in proper synthax

echo.

to view debug message during execution (default disabled)

checkit.

stop execution to inspect variables during execution (default diabled)

longc.

use long (not abbreviated) column names for etiquettes (default disabled)

timeformat.

the date time formato (default "%d/%m/%Y %H:%M:%S")

maxLines.

number of datas lines to read maximally (default -1 read all lines)

Value

An list, or NULL in exception case, with the following properties:

  • xx data array

  • count number of records read

  • datafile datafile

  • tstr time as strings

  • times time vector

  • hh metainfo, header

  • etiq etiquettes (abbreviated metadata)

Examples

read_palma_export(system.file("extdata", "export_version-1.6.csv", package = "palmaexportreader"))
#> $xx
#>   cami.raw.nort.LEQ(.(30m cami.sta.nort.LEQ(.(30m cami.raw.sout.LEQ(.(30m
#> 1                    69.2                       3                    69.1
#> 2                    74.2                       3                    73.8
#> 3                    75.1                       3                    75.4
#> 4                    74.8                       3                    74.9
#> 5                    74.5                       3                    75.1
#> 6                    74.0                       3                    73.9
#>   cami.sta.sout.LEQ(.(30m mole.raw.nort.LEQ(.(30m mole.sta.nort.LEQ(.(30m
#> 1                       3                    69.2                       3
#> 2                       3                    71.9                       3
#> 3                       3                    72.9                       3
#> 4                       3                    72.3                       3
#> 5                       3                    72.3                       3
#> 6                       3                    71.3                       3
#>   mole.raw.sout.LEQ(.(30m mole.sta.sout.LEQ(.(30m reid.raw.nort.LEQ(.(30m
#> 1                    68.8                       3                    69.6
#> 2                    70.6                       3                    72.3
#> 3                    71.8                       3                    73.3
#> 4                    71.2                       3                    73.3
#> 5                    71.9                       3                    72.5
#> 6                    70.8                       3                    70.5
#>   reid.sta.nort.LEQ(.(30m reid.raw.sout.LEQ(.(30m reid.sta.sout.LEQ(.(30m
#> 1                       3                    70.1                       3
#> 2                       3                    71.7                       3
#> 3                       3                    73.1                       3
#> 4                       3                    72.4                       3
#> 5                       3                    72.4                       3
#> 6                       3                    71.0                       3
#>   roth.raw.nort.LEQ(.(30m roth.sta.nort.LEQ(.(30m roth.raw.sout.LEQ(.(30m
#> 1                    63.2                       3                    62.5
#> 2                    68.3                       3                    67.5
#> 3                    68.2                       3                    68.0
#> 4                    68.7                       3                    67.9
#> 5                    67.5                       3                    67.1
#> 6                    65.3                       3                    64.7
#>   roth.sta.sout.LEQ(.(30m tenn.raw.nort.LEQ(.(30m tenn.sta.nort.LEQ(.(30m
#> 1                       3                    69.5                       3
#> 2                       3                    72.3                       3
#> 3                       3                    73.8                       3
#> 4                       3                    73.4                       3
#> 5                       3                    72.4                       3
#> 6                       3                    72.2                       3
#>   tenn.raw.sout.LEQ(.(30m tenn.sta.sout.LEQ(.(30m
#> 1                    72.6                       3
#> 2                    76.7                       3
#> 3                    77.2                       3
#> 4                    76.1                       3
#> 5                    75.0                       3
#> 6                    74.5                       3
#> 
#> $count
#> [1] 6
#> 
#> $datafile
#> [1] "/tmp/Rtmp8eBaUG/temp_libpath46e113d6ddcd/palmaexportreader/extdata/export_version-1.6.csv"
#> 
#> $tstr
#> [1] "01/01/2025 00:15:00" "01/01/2025 00:45:00" "01/01/2025 01:15:00"
#> [4] "01/01/2025 01:45:00" "01/01/2025 02:15:00" "01/01/2025 02:45:00"
#> 
#> $times
#> [1] "2025-01-01 00:15:00 CET" "2025-01-01 00:45:00 CET"
#> [3] "2025-01-01 01:15:00 CET" "2025-01-01 01:45:00 CET"
#> [5] "2025-01-01 02:15:00 CET" "2025-01-01 02:45:00 CET"
#> 
#> $hh
#>       lcode             luogo       x       y   z  param   aggreg   resol
#> 1  noise_06      camignolo a2 2715213 1106164 420 leq(a) raw data (30min)
#> 2  noise_06      camignolo a2 2715213 1106164 420 leq(a)   status (30min)
#> 3  noise_06      camignolo a2 2715184 1106175 420 leq(a) raw data (30min)
#> 4  noise_06      camignolo a2 2715184 1106175 420 leq(a)   status (30min)
#> 5  noise_07         moleno a2 2719805 1127050 256 leq(a) raw data (30min)
#> 6  noise_07         moleno a2 2719805 1127050 256 leq(a)   status (30min)
#> 7  noise_07         moleno a2 2719776 1127043 256 leq(a) raw data (30min)
#> 8  noise_07         moleno a2 2719776 1127043 256 leq(a)   status (30min)
#> 9  noise_02         reiden a2 2639533 1232120 462 leq(a) raw data (30min)
#> 10 noise_02         reiden a2 2639533 1232120 462 leq(a)   status (30min)
#> 11 noise_02         reiden a2 2639512 1232102 462 leq(a) raw data (30min)
#> 12 noise_02         reiden a2 2639512 1232102 462 leq(a)   status (30min)
#> 13 noise_04 rothenbrunnen a13 2751729 1180550 623 leq(a) raw data (30min)
#> 14 noise_04 rothenbrunnen a13 2751729 1180550 623 leq(a)   status (30min)
#> 15 noise_04 rothenbrunnen a13 2751704 1180525 623 leq(a) raw data (30min)
#> 16 noise_04 rothenbrunnen a13 2751704 1180525 623 leq(a)   status (30min)
#> 17 noise_01       tenniken a2 2627966 1253005 437 leq(a) raw data (30min)
#> 18 noise_01       tenniken a2 2627966 1253005 437 leq(a)   status (30min)
#> 19 noise_01       tenniken a2 2627940 1253000 437 leq(a) raw data (30min)
#> 20 noise_01       tenniken a2 2627940 1253000 437 leq(a)   status (30min)
#>    meas.point   h units
#> 1       north 3.2  [db]
#> 2       north 3.2      
#> 3       south 3.2  [db]
#> 4       south 3.2      
#> 5       north 3.2  [db]
#> 6       north 3.2      
#> 7       south 3.2  [db]
#> 8       south 3.2      
#> 9       north 3.2  [db]
#> 10      north 3.2      
#> 11      south 3.2  [db]
#> 12      south 3.2      
#> 13      north 3.2  [db]
#> 14      north 3.2      
#> 15      south 3.2  [db]
#> 16      south 3.2      
#> 17      north 3.2  [db]
#> 18      north 3.2      
#> 19      south 3.2  [db]
#> 20      south 3.2      
#> 
#> $etiq
#>       [,1]                      [,2]                                
#>  [1,] "cami.raw.nort.LEQ(.(30m" "camignol|rawdata|north|LEQ(A)|(30m"
#>  [2,] "cami.sta.nort.LEQ(.(30m" "camignol|status|north|LEQ(A)|(30m" 
#>  [3,] "cami.raw.sout.LEQ(.(30m" "camignol|rawdata|south|LEQ(A)|(30m"
#>  [4,] "cami.sta.sout.LEQ(.(30m" "camignol|status|south|LEQ(A)|(30m" 
#>  [5,] "mole.raw.nort.LEQ(.(30m" "molenoa|rawdata|north|LEQ(A)|(30m" 
#>  [6,] "mole.sta.nort.LEQ(.(30m" "molenoa|status|north|LEQ(A)|(30m"  
#>  [7,] "mole.raw.sout.LEQ(.(30m" "molenoa|rawdata|south|LEQ(A)|(30m" 
#>  [8,] "mole.sta.sout.LEQ(.(30m" "molenoa|status|south|LEQ(A)|(30m"  
#>  [9,] "reid.raw.nort.LEQ(.(30m" "reidena|rawdata|north|LEQ(A)|(30m" 
#> [10,] "reid.sta.nort.LEQ(.(30m" "reidena|status|north|LEQ(A)|(30m"  
#> [11,] "reid.raw.sout.LEQ(.(30m" "reidena|rawdata|south|LEQ(A)|(30m" 
#> [12,] "reid.sta.sout.LEQ(.(30m" "reidena|status|south|LEQ(A)|(30m"  
#> [13,] "roth.raw.nort.LEQ(.(30m" "rothenbr|rawdata|north|LEQ(A)|(30m"
#> [14,] "roth.sta.nort.LEQ(.(30m" "rothenbr|status|north|LEQ(A)|(30m" 
#> [15,] "roth.raw.sout.LEQ(.(30m" "rothenbr|rawdata|south|LEQ(A)|(30m"
#> [16,] "roth.sta.sout.LEQ(.(30m" "rothenbr|status|south|LEQ(A)|(30m" 
#> [17,] "tenn.raw.nort.LEQ(.(30m" "tenniken|rawdata|north|LEQ(A)|(30m"
#> [18,] "tenn.sta.nort.LEQ(.(30m" "tenniken|status|north|LEQ(A)|(30m" 
#> [19,] "tenn.raw.sout.LEQ(.(30m" "tenniken|rawdata|south|LEQ(A)|(30m"
#> [20,] "tenn.sta.sout.LEQ(.(30m" "tenniken|status|south|LEQ(A)|(30m" 
#>