Cabinetry

This release makes use of the new `pyhf` version 0.5.4 to avoid `uproot` namespace collisions. It also completes the package name migrations `awkward1` -> `awkward>=1.0.0` and `uproot4` -> `uproot>=4.0.0`.

**Full list of changes:**
- chore: updating version to 0.1.7 (165)
- fix: finalize uproot/awkward name migration and update to pyhf 0.5.4 (164)

This release restricts `iminuit` to major version 1. The update to v2 will happen in parallel with `pyhf`. The release also adds functionality to calculate upper parameter limits, goodness-of-fit, yield tables, and expands the command line interface.

**Breaking changes:**
- The `custom` fit keyword argument (to switch between `pyhf.infer` and `iminuit`) is now called `custom_fit`.
- The order of arguments for `visualize.data_MC` changed: the workspace specification is now the second required argument, while the figure output folder is the third function argument and optional. This makes the behavior consistent with similar functions. Example for the new signature: `cabinetry.visualize.data_MC(cabinetry_config, ws)`
- `fit.ScanResults.scan_values` is now called `fit.ScanResults.parameter_values`

**Full list of changes:**
- chore: updating version to 0.1.6 (162)
- feat: yield tables (159)
- fix: uproot package name migration to uproot3 (157)
- feat: command line interface for parameter limits (155)
- feat: expansion of fit command line interface (154)
- style: move MINOS function to better position (153)
- feat: better handling of unknown parameters when running MINOS (152)
- feat: goodness of fit test with saturated model (131)
- chore: Add pyupgrade to pre-commit hooks (151)
- chore: update pre-commit hook versions (149)
- fix: iminuit.Minuit type hints (148)
- feat: support pyhf.infer fits for ranking and parameter scans (147)
- refactor: common entry point for maximum likelihood fits (146)
- feat: extend parameter control when using pyhf.infer (145)
- feat: default output folder for visualizations (144)
- feat: upper parameter limits (134)
- feat: support stdin/stdout piping in command line interface (143)
- docs: contribution guidelines (139)

This release makes `cabinetry` compatible with `pyhf` version 0.5.3. It also adds MINOS uncertainty calculation and treats initial parameter settings for normalization factors as the nominal setting for Asimov dataset generation.

**Full list of changes:**
- chore: updating version to 0.1.5 (137)
- fix: pyhf 0.5.3 compatibility (135)
- feat: treat initial normalization factor settings as nominal values (136)
- style: docstring line length (133)
- feat: adding functionality to run MINOS (132)

This release fixes the data/MC visualization of workspaces with three and more channels. It adds small plotting improvements and a command line interface for nuisance parameter ranking and likelihood scans.

**Full list of changes:**
- chore: updating version to 0.1.4 (130)
- fix: visualization of three and more channels (129)
- style: consistent maximum line length (128)
- feat: skip ranking for fixed parameters (126)
- refactor: sample order for data/MC plot legend (125)
- ci: adding sphinx docs building (124)
- feat: log scale for data/model plots (119)
- ci: Add nightly tests using HEAD of dependencies (123)
- feat: command line interface for ranking and scan (122)

This release makes `awkward1` a core dependency, which was missing from version `0.1.2`. It adds nuisance parameter ranking, likelihood scans and their visualization to `cabinetry`, as well as support for multiple input files per sample.

**Breaking changes:**
- `SamplePath` is renamed to `SamplePaths` (117)
- `configuration.read` is renamed to `configuration.load` (118)
- due to a change in capitalization of the nominal systematic name, histograms built with earlier versions need to be renamed (108)

**Full list of changes:**
- chore: updating version to 0.1.3 (121)
- feat: likelihood scan (120)
- feat: nuisance parameter ranking (116)
- refactor: configuration loading (118)
- feat: support reading multiple input files per sample (117)
- fix: close matplotlib figures after saving (115)
- fix: make awkward1 core dependency (114)
- test: integration test isolation (109)
- refactor: capitalization of nominal systematic (108)
- refactor: model building and model reuse (107)

This release adds pre- and post-fit plots with total model uncertainty bands. It introduces a more flexible method for input file path specification, and systematics templates can be visualized separately for debugging purposes.

**Breaking changes:**
- new mandatory config option: `InputPath` (see 98)
- `visualize.data_MC` moved to `visualize.data_MC_from_histograms`, and `visualize.data_MC` now draws full model uncertainty bands

**Full list of changes:**
- chore: updating version to 0.1.2 (106)
- feat: pre- and post-fit plots with full model uncertainty bands (96)
- feat: visualization of ntuple creation utility can be disabled (105)
- feat: skip fixed parameters in pull plot and correlation matrix (104)
- chore: moving metadata to setup.cfg (103)
- feat: visualization of systematics templates (102)
- style: update to black 20.8 formatting (99)
- feat: more flexible input file path handling (98)
- feat: ranking plot (97)
- feat: Asimov fits (95)
- feat: support reading vector branches (94)
- feat: removing staterrors from pull plot (93)
- feat: set default interpolation method (92)