Add script to sample a single location

[nweires]

Pull Request Description

Add a script that runs the residential quota sampler for a single county+PUMA.

Using the downselect sampler to do the same thing works, but it gets very slow when you filter aggressively. For example, generating 100 buildings for a single rural county took more than an hour to run. With this script, it takes just a few minutes. A similar option for ComStock exists here.

Checklist

• Code changes (must work)
• Tests exercising your feature/bug fix (check coverage report on Checks -> BuildStockBatch Tests -> Artifacts)
• Coverage has increased or at least not decreased. Update minimum_coverage in .github/workflows/coverage.yml as necessary.
• All other unit and integration tests passing
• Update validation for project config yaml file changes
• Update existing documentation
• Run a small batch run on Kestrel/Eagle to make sure it all works if you made changes that will affect Kestrel/Eagle
• Add to the changelog_dev.rst file and propose migration text in the pull request

[github-actions]

File	Coverage
All files	87%	✅
base.py	92%	✅
exc.py	57%	✅
hpc.py	78%	✅
local.py	70%	✅
postprocessing.py	85%	✅
sample_one_county.py	77%	✅
utils.py	92%	✅
cloud/docker_base.py	88%	✅
sampler/base.py	79%	✅
sampler/downselect.py	33%	✅
sampler/precomputed.py	93%	✅
sampler/residential_quota.py	61%	✅
test/shared_testing_stuff.py	85%	✅
test/test_docker.py	33%	✅
test/test_local.py	97%	✅
test/test_validation.py	97%	✅
workflow_generator/base.py	90%	✅
workflow_generator/commercial.py	53%	✅
workflow_generator/residential_hpxml.py	86%	✅

Minimum allowed coverage is 33%

Generated by 🐒 cobertura-action against 6beba8c

[shorowit]

@nweires I might be misunderstanding something, but isn't this what the Residential Quota Downselect Sampler is for?

[nweires]

@nweires I might be misunderstanding something, but isn't this what the Residential Quota Downselect Sampler is for?

Ah, yes, I should add some context for why this is useful! You can do the same thing with the downselect sampler, but this is much faster, especially rural locations with very few building. I'll put some notes about that in the script and PR description.