3DBAG / 3DBAG/3dbag-docs

Describe why we use the 70th percentile in the viewer

Open
#29 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
0
Forks
0
PR merge metrics
No merged PRs in 30d

Description

And how does that relate to the data in general.

"Because its a good general value to describe the height of the building. The value of the 70th percentile tends to be closer to the ridge of the roof than the min. or the 50th percentile, and excludes the height of the chimneys or other objects on the roof. This it what most people are interested in I think, so we display the h_dak_70p value in the viewer. And including all the h_dak percentiles would be too much info in the viewer. Note, that the data downloads contain all the h_dak values.
Additionally, we also use the 70th percentile for the data sets that we are developing for noise simulations (3DGeluid), because we need a roof height value that approaches the real ridge of the roof as close as possible, but excludes the extra object on top of the roof.

But keep in mind that the h_dak values are "just" percentiles of the roof height, and not an exact reference to particular parts of the roof (eaves, ridge etc.).

All this said, all the other height percentiles, min, 50, max are just as good and valid choice as the 70th. It all depends on what do you need the height values for. For instance, if you are interested in the lowest height of the roof (eg. for taxation, energy use estimation etc), then the min is a good choice. If you want to know the elevation at which is safe for drones to fly around, then you need the max height. As you see, it all depends on your use case.
"

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start from the viewer documentation and the supplied explanation of h_dak percentiles and 3DGeluid. Document why the viewer uses the 70th percentile, how it relates to roof-height data and downloads, and that other percentiles remain valid for different use cases.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.