Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Iss 24 #29

Merged
merged 7 commits into from
May 28, 2024
Merged

Iss 24 #29

merged 7 commits into from
May 28, 2024

Conversation

alpha-beta-soup
Copy link
Member

An attempt to cover #24 for the draft report.

  • What is the appropriate license? #17: CC BY 4.0 License (but this repo is still private for now).
  • Include the "why"  #16: Make reference to the idea of enduring questions (advice from Māori synthesis) and whakataukī.
  • Principle 1 rephrasing #22: Be clearer about what "atomic" means by listing synonyms, and also engaging with the Māori synthesis to be clear that using a grid is to be preferred to a pre-existing geographi object like a parcel as it makes it less extensible and flexible, and therefore less able to accomodate use by Māori organisations.
  • Principle of data sovereignty #18 As above, i.e. indigenous data sovereignty.

TODO

  • Consider enduring questions to be addressed by the "NZLUMT" (as it is currently named)

README.md Outdated
- Collect primary data in place of secondary categorical data, where feasible.
1. #### Be specific about purpose and scope
- Each classification is designed for an explicit spatiotemporal geographic unit.
- Atomic geographic units, such as DGGS zones, should be preferred over pre-existing geographic units such as proepty boundaries.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove atomic; not the word we want here.
A DGGS, assuming we 'standardize' one (H3?), provides a fixed, persistent, reproducible grid without relying on imprecise 'boundary' information provided by councils, LINZ, StatsNZ, local planners, engineers, architects, etc.; all of which could, and probably do, differ.

Fix property typo

README.md Outdated

## Principles <!-- Informative -->

1. #### Prioritise atomic data (i.e. decomposition of multidimensional attributes, e.g. tenure)
- Break down information being collected into individual (atomic) attributes.
- Break down information being collected into individual (atomic, primitive, indivisible) attributes.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Expose data behind categories? High-producing grassland means little until grassland and high-producing are unpacked--e.g. grassland includes N species (list?) and high-producing is everything above X bushels per hectare (or whatever) for this area (DGGS cell).

README.md Outdated
- Collect primary data in place of secondary categorical data, where feasible.
1. #### Be specific about purpose and scope
- Each classification is designed for an explicit spatiotemporal geographic unit.
- Atomic geographic units, such as DGGS zones, should be preferred over pre-existing geographic units such as proepty boundaries.
- A classification system does not have to be comprehensive, and may consider some land use types "out of scope", according to the purpose.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

instead of 'may' I suggest something like, 'will almost certainly'

README.md Outdated
- A classification system does not have to be comprehensive, and may consider some land use types "out of scope", according to the purpose.
1. #### Classification systems should be extensible
- Ensure flexibility for land use classification systems which support indigenous data sovereignty protocols (see [Te Mana Raraunga – Māori Data Sovereignty Network)](https://www.temanararaunga.maori.nz/)).
1. #### Hierarchies are encouraged where appropriate
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hierarchies are encouraged where appropriate, required and logically consistent

@@ -21,6 +27,8 @@ NZLUMT is an adaptation of the Australian Land Use and Management (ALUM) Classif

The NZLUMT is intended for the purpose of land use change modelling and environmental monitoring (especially for fresh water management). Land use practices are of particular relevance to this classification system, as there is a need to understand social and economic capacity for changes to land management practices. Land tenure is also a compulsory attribute as it relates to the potential for changes to land use and land use management practices (i.e. tenure may constrain possibile changes).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we need to call out fresh water management, specifically?


This work is licensed under a
[Creative Commons Attribution 4.0 International License][cc-by].
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This seems fine for now. I suspect there will need to be bits licensed separately downstream.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also, if we are going to go with attribution (which I agree with) we should pipe this through Zenodo so we can get a proper DOI, and add a subsequent CITATION.cff file for the repository.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

....or contact Alla (or whomever in the library) to procure a Manaaki Whenua generated DOI.

(Apologies for the tangent.)

README.md Outdated
Different land use maps are made for different intended purposes, because of the necessity of making decisions about how information is organised that constrain its appliciblity. It is a best practice to explicitly state the purpose for which land use classification systems are designed. This purpose will inform other decisions. When deciding on this purpose, consider what questions are likely to be answered if land use information is systematically organised according to the classification system. A 2013 Stats NZ report[^2] provides a useful framing for these questions as "enduring", i.e. questions that don't really change over time, but the way we answer them (under a type of system or architecture) does.

A choice of geographic unit that make extension and re-organisation of land use information difficult (such as property parcels) can be made for _pragmatic_ reasons, but should be justified. Possible justifications include: alignment with existing tools or published data, computational feasibility, the expected absense of finer-scale input data, restrictions on the use of required input data, or privacy. Where possible, a specification to use grids without pre-defined boundaries (such as [DGGS zones](https://docs.ogc.org/as/20-040r3/20-040r3.html), or raster grids) should be preferred.

### Scope

Land use classification systems _may_ only consider a few land use types, and consider others as being "out of scope". For example, a classification of protected land may choose to classify all other land as "non-protected" without attempting any form of further classification, according to the purpose of that classification system.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

...without attempting more precise classification, according to...

README.md Outdated
<!-- ![a worked example](figs/Framework-Classification-01.png)
Fig N. Overview figure. -->

### Purpose

Different land use maps are made for different intended purposes, because of the necessity of making decisions about how information is organised that constrain its appliciblity. It is a best practice to explicitly state the purpose for which land use classification systems are designed. This purpose will inform other decisions. When deciding on this purpose, consider what questions are likely to be answered if land use information is systematically organised according to the classification system. A 2013 Stats NZ report[^2] provides a useful framing for these questions as "enduring", i.e. questions that don't really change over time, but the way we answer them (under a type of system or architecture) does.

A choice of geographic unit that make extension and re-organisation of land use information difficult (such as property parcels) can be made for _pragmatic_ reasons, but should be justified. Possible justifications include: alignment with existing tools or published data, computational feasibility, the expected absense of finer-scale input data, restrictions on the use of required input data, or privacy. Where possible, a specification to use grids without pre-defined boundaries (such as [DGGS zones](https://docs.ogc.org/as/20-040r3/20-040r3.html), or raster grids) should be preferred.
Copy link
Collaborator

@brandonnodnarb brandonnodnarb May 27, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

suggest re-wording...

Choice of geographic unit may make extension and re-organisation of land use information difficult, e.g. property parcels. Obviously there are pragmatic reasons for choices of this nature. Be mindful of knock-on effects stemming from what are effectively modelling decisions. Potential issues include, but are not limited to, alignment with existing tools or published data, computational (in)feasibility, the expected absence of finer-scale input data, restrictions on the use of required input data, or privacy. Where possible, a specification to use grids without pre-defined boundaries (such as DGGS zones, or raster grids) should be preferred.

README.md Outdated
<!-- ![a worked example](figs/Framework-Classification-01.png)
Fig N. Overview figure. -->

### Purpose

Different land use maps are made for different intended purposes, because of the necessity of making decisions about how information is organised that constrain its appliciblity. It is a best practice to explicitly state the purpose for which land use classification systems are designed. This purpose will inform other decisions. When deciding on this purpose, consider what questions are likely to be answered if land use information is systematically organised according to the classification system. A 2013 Stats NZ report[^2] provides a useful framing for these questions as "enduring", i.e. questions that don't really change over time, but the way we answer them (under a type of system or architecture) does.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

suggest modifying first sentence.

Land use information is collected at multiple scales for a variety of purposes which directly, and indirectly, affects relevant decisions based on how that information is organised and/or applied.

README.md Outdated
@@ -49,6 +61,7 @@ The list of best practices for land use classification systems under this framew
<!-- 1. Data product specification, e.g. ISO 19131:2022 -->
1. **Purpose** Land use classification systems shall describe their intended use-cases.
1. **Scope** Land use classification systems shall describe their intended scope.
1. **Extensibility** Ensure flexibility for land use classification systems to interact with Māori attribute layers that maintain indigenous data sovereignty.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Extensibility Ensure flexibility for land use classification systems to interact (connect? relate?) with other land use data and classification systems. This must include, for example, Māori attribute layers that maintain indigenous data sovereignty.

README.md Outdated
### Scope

Land use classification systems _may_ only consider a few land use types, and consider others as being "out of scope". For example, a classification of protected land may choose to classify all other land as "non-protected" without attempting any form of further classification, according to the purpose of that classification system.

### Extensibility

It should always be possible to "extend" or "widen" a classification system with more properties/attributes that can be determined by other users, such that information can be re-organised, re-presented, and corrected according to local priorities, to be owned by hapū and iwi without an expectation that this will be visible "upstream".
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can it be owned by individuals as well? (e.g. owned by hapū, iwi, or individuals?)

README.md Outdated
Different land use maps are made for different intended purposes, because of the necessity of making decisions about how information is organised that constrain its appliciblity. It is a best practice to explicitly state the purpose for which land use classification systems are designed. This purpose will inform other decisions. When deciding on this purpose, consider what questions are likely to be answered if land use information is systematically organised according to the classification system. A 2013 Stats NZ report[^2] provides a useful framing for these questions as "enduring", i.e. questions that don't really change over time, but the way we answer them (under a type of system or architecture) does.

A choice of geographic unit that make extension and re-organisation of land use information difficult (such as property parcels) can be made for _pragmatic_ reasons, but should be justified. Possible justifications include: alignment with existing tools or published data, computational feasibility, the expected absense of finer-scale input data, restrictions on the use of required input data, or privacy. Where possible, a specification to use grids without pre-defined boundaries (such as [DGGS zones](https://docs.ogc.org/as/20-040r3/20-040r3.html), or raster grids) should be preferred.

### Scope

Land use classification systems _may_ only consider a few land use types, and consider others as being "out of scope". For example, a classification of protected land may choose to classify all other land as "non-protected" without attempting any form of further classification, according to the purpose of that classification system.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

First line:
Land use classification systems need not be comprehensive. They may only consider a few land use types...

Copy link
Collaborator

@brandonnodnarb brandonnodnarb left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like the edits. I've added some comments for your consideration.

@alpha-beta-soup alpha-beta-soup merged commit 53e12a7 into main May 28, 2024
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants