Documentation updates: data processing sections

[leewujung]

Detailed changes

This PR includes a number of documentation updates:

• revise description of dimensions of raw converted files: now the extra beam dimension is dropped for all non-complex data
• add subpackagesnot already rendered in API reference
  • add consolidate
  • add metrics
• overhaul and reorganize the Data processing section
  • change to use notebook
  • overhaul description of cal_params and env_params spec
  • put in the allowable params for each instrument type
  • document support for Echoview ECS file
• clarify range_sample and echo_range and depth (Detail how range_sample is converted to echo_range in docs #597)
• document nan-padding strategy (Detail how range_sample is converted to echo_range in docs #597)

Summary

• The previous Data format section is now renamed to Raw data format
• There is a new Data processing section, which contains 2 pages:
• data-proc-func.ipynb: providing a summary of processing functionalities and usage examples, especially for cal_params and env_params for calibration
• data-proc-additional.ipynb: a one-stop-shopping place for additional details for processing functions
  • this page contains some information that was previously in data-format-processed.ipynb under the previous Data format section

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[codecov-commenter]

Codecov Report

Merging #1093 (b66439f) into dev (7c0c818) will decrease coverage by 58.22%.
The diff coverage is 100.00%.

@@             Coverage Diff             @@
##              dev    #1093       +/-   ##
===========================================
- Coverage   80.41%   22.19%   -58.22%     
===========================================
  Files          64       65        +1     
  Lines        6044     6046        +2     
===========================================
- Hits         4860     1342     -3518     
- Misses       1184     4704     +3520     

Flag	Coverage Δ
unittests	22.19% <100.00%> (-58.22%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files Changed	Coverage Δ
echopype/__init__.py	100.00% <ø> (ø)
echopype/consolidate/api.py	93.75% <ø> (ø)
echopype/metrics/__init__.py	100.00% <100.00%> (ø)

... and 48 files with indirect coverage changes

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[leewujung]

I'll self-merge now to get these changes in, in prep for the release.