QField icon indicating copy to clipboard operation
QField copied to clipboard

"Altitude" is confusing and doesn't match docs

Open gdt opened this issue 5 months ago • 1 comments

What is the bug or the crash? What were your expectations and what actually happened?

At https://docs.qfield.org/how-to/gnss/ the altitude field is documented to just show a value in m, or to be annotated with "(ortho.)" or "(grid)". Also the documentation says the "height of the pole" can be entered. (Surely this is the APC - mark offset, but that's minor terminology.)

I therefore expect to see, in the base case, an HAE value which is the receiver's HAE minus the antenna height. I am pretty sure that I am indeed seeing this. However, on my screen is "Altitude: ab.cde m (ant.)". That's very confusing, as it implies the antenna height compensation isn't happening. If, on internal GNSS, I flip to device orthometric, it changes to ortho. But APC vs mark is not addressed.

I would suggest:

  • change Altitude (a very confusing/loaded word) to "Height"
  • in parens, use one of "(HAE)", "(ortho.)", or "(grid)".

Yes, I know many will not understand HAE but that's what it is, and it's better it they don't know it, that they either study for GISP :-) or look it up, than to be told something they think they understand and don't.

With all of these, it should be the position solution minus the antenna height compensation, as documented.

Steps to reproduce the issue

Configure a height compensation, and change the various values as described.

Version

3.6.8

Operating system name

Android

Operating system version

A15, CalyxOS

Reinstall QField

  • [ ] I have a fresh install of the latest QField version, but the problem persists.
  • [x] Problem can be reliably reproduced, doesn't happen randomly.
  • [x] Problem happens with all files and projects, not only some files or projects.

Additional context

No response

gdt avatar Jul 23 '25 23:07 gdt

Further, not really about this bug, builtin geoid models are as far as I can tell always terrible. So people are not well served by device orthometric height.

gdt avatar Jul 23 '25 23:07 gdt