get_all()

It is often useful to get quick information out of an ecopart_obj at the start of a project. get_all() is a useful funciton for these quick, interactive tasks. This will return a vector of all observations for that column. Alone this data may be overwhelming, so it is a good idea to combine it with next-step summary function like range(), mean(), max(), etc.

If you are interested in pulling just a

What is the depth range of observations?

library(EcotaxaTools)
ecopart_example |> 
    get_all('depth_including_offset') |>
    range()

[1]    2.9 3499.9

What is the average size?

When working with an ecopart_obj, all the size based metrics will still be in pixels, not mm. get_all() has an argument for converting pixels to mm. For this to work, you must provide an ecopart_obj, not just a zoo_list.

ecopart_example |>
    get_all('esd', pixel_conv = T) |>
    mean()

[1] 1.41243

Additional Info:

When using, users must specify which column they are interested in querying from the zoo_df. If unfamiliar with these names you can access them by getting the column names of any single zoo_df

ecopart_example$zoo_files$bats361_ctd1 |> 
    names()

 [1] "orig_id"                "objid"                  "name"                  
 [4] "taxo_hierarchy"         "classif_qual"           "depth_including_offset"
 [7] "psampleid"              "%area"                  "angle"                 
[10] "area"                   "area_exc"               "areai"                 
[13] "bx"                     "by"                     "cdexc"                 
[16] "centroids"              "circ."                  "circex"                
[19] "compentropy"            "compm1"                 "compm2"                
[22] "compm3"                 "compmean"               "compslope"             
[25] "convarea"               "convarea_area"          "convperim"             
[28] "convperim_perim"        "cv"                     "elongation"            
[31] "esd"                    "fcons"                  "feret"                 
[34] "feretareaexc"           "fractal"                "height"                
[37] "histcum1"               "histcum2"               "histcum3"              
[40] "intden"                 "kurt"                   "kurt_mean"             
[43] "major"                  "max"                    "mean"                  
[46] "meanpos"                "median"                 "median_mean"           
[49] "median_mean_range"      "min"                    "minor"                 
[52] "mode"                   "nb1"                    "nb1_area"              
[55] "nb1_range"              "nb2"                    "nb2_area"              
[58] "nb2_range"              "nb3"                    "nb3_area"              
[61] "nb3_range"              "perim."                 "perimareaexc"          
[64] "perimferet"             "perimmajor"             "range"                 
[67] "skelarea"               "skeleton_area"          "skew"                  
[70] "skew_mean"              "slope"                  "sr"                    
[73] "stddev"                 "symetrieh"              "symetrieh_area"        
[76] "symetriehc"             "symetriev"              "symetriev_area"        
[79] "symetrievc"             "tag"                    "thickr"                
[82] "width"                  "x"                      "xm"                    
[85] "xmg5"                   "xstart"                 "y"                     
[88] "ym"                     "ymg5"                   "ystart"