F2. PROTOCOLS & CODES OF CONDUCT - colouring-cities/manual GitHub Wiki

This section provides information on:

Click here for information on the CCRP's ethical framework and ethics policies.

CCRP Contributor Code of Conduct

This Code of Conduct is adapted from the Contributor Covenant, version 1.4

Contributors' Pledge

In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to make participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation. Our Standards

Examples of behaviour that contributes to creating a positive environment include:

Using welcoming and inclusive language
Being respectful of differing viewpoints and experiences
Gracefully accepting constructive criticism
Focusing on what is best for the community
Showing empathy towards other community members

Examples of unacceptable behaviour by participants include:

The use of sexualized language or imagery and unwelcome sexual attention or advances
Trolling, insulting/derogatory comments, and personal or political attacks
Public or private harassment
Publishing others' private information, such as a physical or electronic address, without explicit permission
Other conduct which could reasonably be considered inappropriate in a professional setting

Project Maintainer Responsibilities

Project maintainers are responsible for clarifying the standards of acceptable behaviour and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behaviour.

Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviours that they deem inappropriate, threatening, offensive, or harmful or not within scope.

This Code of Conduct applies within all project spaces, and it also applies when an individual is representing the project or its community in public spaces. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers. Enforcement

Instances of abusive, harassing, or otherwise unacceptable behaviour may be reported by contacting the individual academic teams for each country. All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted by individual CCRP academic hosts separately.

Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.

For answers to common questions about this code of conduct, see https://www.contributor-covenant.org/faq"

CCRP Equality, Diversity and Inclusion Policy

The CCRP is a collaborative initiative and welcomes all contributions in line with its Contributor Code of Conduct. CCRP platforms are designed for everyone to use, and to be as inclusive, welcoming and accessible as possible. We actively seek diversity of contributors and audiences, celebrate diversity of knowledge and consider engagement of contributors of diverse ages, genders, skills and abilities, and cultural backgrounds as critical to platform success. We use colour, crowdsourcing, and non-technical language to reduce barriers to knowledge sharing and the contribution of statistical information on building stocks, and to make the process of engagement rewarding and interesting. All interface features are designed to be as accessible and inclusive as possible. If you have suggestions on how to make Colouring platforms more inclusive please add ideas as a GitHub issue or comment on the Discussion Fora on individual CCRP platforms. Further information on the Alan Turing Institute's equality, diversity and Inclusion policies may be accessed here. CCRP academic partners will also provide links to EDI policies relating to their specific research institution.

CCRP Contributor Privacy Policy

Colouring Cities platform users are actively discouraged from providing personal data. Users are not required to add personal information to use the site. The site is free to view and for those wishing to edit only a username and password are required. The email address is currently optional. If provided this allows us to send the user an email to reset their password if they forget it, and in exceptional circumstances contact a user directly if it looks like they are misusing the site, for example to let them know if we plan to disable or remove their account.

Privacy Statements are set-out by each CCRP international academic partner on the Menu section of CCRP platforms. Though CCRP privacy policies for individual countries may be similar, precise wording may differ depending on local regulations, and academic host requirements. Privacy Statement text used for 'Colouring London' shown below:

"This privacy policy explains how Colouring London uses the personal data we collect from you when you use our website. Colouring London is a research project initially developed by the Bartlett Centre for Advanced Spatial Analysis (CASA) at UCL, and now run at The Alan Turing Institute. Colouring London is registered for data protection purposes with The Alan Turing Institute data protection office.

What data do we collect? Colouring London collects the following personal data: A username and email address. We recommend you do not use your actual name for your username. We also collect your password, which is stored as a cryptographic hash unique to Colouring London.
How do we collect your data?: You provide Colouring London with a minimal amount of personal data when you register with the website and accept the terms and conditions including this privacy policy.
What purposes do we use your data?: Colouring London uses your personal data to enable you to login to access and contribute to the Colouring London project and to provide a personalised user experience when you are logged in. We will not share your personal data (such as your email address) with any other parties or use your personal data for any purposes other than the Colouring London project._____
If you request a password reset, an automated email will be sent using Mailgun, who process the email in order to deliver it to your email address. Mailgun retain personal data they process on behalf of Colouring London for as long as is needed to provide email services. Mailgun will retain the personal information as necessary to comply with their legal obligations, resolve disputes, and enforce their agreements.
What is the legal basis for processing your data? Data protection laws require us to meet certain conditions before we are allowed to use your data in the manner described in this notice, including having a ‘legal basis’ for the processing. Colouring London, as a research project, is processing your personal data in pursuance of its legitimate interests.
How do we store your data? Colouring London stores your data at The Alan Turing Institute in London behind the organisation’s firewall in a secure database using industry standard practices. The email address is stored in a database which can only be accessed from within the local network of the Colouring London application server, and is only accessible to select developers working on the project. Users of the Colouring London site can only access their own information (there is no "admin panel" or other kind of user with special access) and connect to the site using standard HTTPS encrypted communications. Documentation of crypt and gen_salt used can be found here. User's personal data is collected upon registration with the Colouring London website. The user's username, password and optional email address (discouraged, and used only for resetting password) is collected over a secure connection (HTTPS). Users are encouraged not to use their actual names for their username. The username, email address and encrypted password (salted cryptographic hash) are stored in the Colouring London database, currently located behind the Alan Turing Institute's firewall. This is in the process of being moved to a Turing Azure subscription. At subsequent logins, the user submits their username and password over a secure connection (HTTPS) and these values are authenticated against those stored in the database (in the case of the password, a salted hash of the password submitted by the user is compared with the salted hash stored in the database).
How do we use cookies? Colouring London only uses cookies to improve the user experience of users of the website, for example we use cookies to keep you signed in. We do not use cookies for marketing or advertising purposes.
What are your data protection rights? Under the General Data Protection Regulation, you have certain individual rights in relation to the personal information we hold about you. For the purposes of research where such individual rights would seriously impair research outcomes, such rights are limited. However, subject to certain conditions, you have the following rights in relation to your personal data: a) A right to access personal data held by us about you, b) A right to require us to rectify any inaccurate personal data held by us about you, c) A right to require us to erase personal data held by us about you. This right will only apply where, for example, we no longer need to use the personal data to achieve the purpose we collected it for, d) A right to restrict our processing of personal data held by us about you. This right will only apply where, for example, you dispute the accuracy of the personal data held by us; or where you would have the right to require us to erase the personal data but would prefer that our processing is restricted instead; or where we no longer need to use the personal data to achieve the purpose we collected it for, but we require the data for the purposes of dealing with legal claims, e) A right to receive personal data, which you have provided to us, in a structured, commonly used and machine-readable format. You also have the right to require us to transfer this personal data to another organisation, f) A right to object to our processing of personal data held by us about you, g) A right to withdraw your consent, where we are relying on it to use your personal data, h) A right to ask us not to use information about you in a way that allows computers to make decisions about you and ask us to stop.
It is important to understand that the extent to which these rights apply to research will vary and that in some circumstances your rights may be restricted. If you notify us (using the contact details set out below) that you wish to exercise any of the above rights and it is considered necessary to refuse to comply with any of your individual rights, you will be informed of the decision within one month and you also have the right to complain about our decision to the Information Commissioner’s Office.
Please also note that we can only comply with a request to exercise your rights during the period for which we hold personal information about you. If that information has been irreversibly anonymised and has become part of the research data set, it will no longer be possible for us to access your personal information.
Who do I contact with questions? If you wish to complain about our use of your personal data or exercise any of your rights, please contact the Turing's Data Protection Officer: [email protected] or Data Protection Officer, The Alan Turing Institute, 96 Euston Road, London NW1 2DB. If we are unable to adequately address any concerns you may have about the way in which we use your data, you have the right to lodge a formal complaint with the UK Information Commissioner's Office. Full details may be accessed on the complaints section of the Information Commissioner's Office website.
What are you contributing to? Colouring Cities platforms are free knowledge exchange platforms/open databases designed for public use. These have been set up to support a whole-of-society approach to improving the sustainability, resilience and inclusivity of cities and form part of the Colouring Cities Research Programme (CCRP) managed by the Alan Turing Institute. The CCRP releases all its code, data and platform development methods under open licences (see below). The CCRP's design is guided by principles set out in the United Nations New Urban Agenda, the Open Data Charter, the General Data Protection Regulation (GDPR), The Gemini Principles, the Open Data Institute's recommendations on personal data, on data infrastructure and relating to its data ethics canvas, and specific Articles within the Declaration of Human rights. Further information on these may be obtained here.
Please note when you make a contribution to Colouring London, you are creating a permanent, public record of all data added, removed, or changed by you. The database records the username and ID of the user making the edit, along with the time and date of the change. All of this information is also made publicly available through the website and through bulk downloads of the edit history. User names of contributors providing the highest number of edits are also included in our Leaderboards.
Please note that when you contribute to Colouring London, you make your contributions available as open data for anyone to copy, distribute, transmit and adapt in line with the licence, and to use as they see fit. Though we rigorously assess each data type, to help protect building occupiers' privacy and security we cannot take responsibility for the way in which data are used (see 'CCRP Contributor & Data User Data Accuracy & Ethical Use Agreement' below. We welcome any ideas for improvements regarding privacy and security, and encourage posting of these on our Discussion forum.
Progress on Colouring London features specifically designed to address ethical issues, including those relating to security and privacy, can also be tracked and commented on using our GitHub site. If you have any immediate concerns regarding security or privacy please contact Turing's data protection team at [email protected].
This privacy policy was last reviewed/updated on 5th June 2023."

CCRP Contributor & Data User Data Accuracy & Ethical Use Agreement

Colouring Cities Research Programme (CCRP) data are provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, accuracy, fitness for a particular purpose and non-infringement. In no event shall the Alan Turing Institute or the ............ (add required field for platform host) be liable for any reliance that you place on or how you use the data nor any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the data or the use or other dealings in the data.

CCRP data are crowdsourced from multiple sources and may contain errors. It is wholly up to the user of Colouring Cities data to ensure that these are sufficiently accurate for their purpose and that they are used in a responsible, ethical and constructive way. Though we cannot comment on data accuracy, we include as many features as possible to help users assess their reliability and suitability for specific types of use (e.g. a school project or scientific paper). We do not accept any data derived from copyrighted or restricted sources, other than those covered by fair use, nor from illegal sources, and we ask contributors to carefully check their sources prior to upload. Our aim is to make our data as reliable and useful as possible. We also ask contributors to prioritise inclusion of sources and to verify other data entries wherever possible.

Colouring Cities Contributors and Data users agree to:

take full responsibility for their use of data - as set out above
never knowingly add data that derives from a restricted, copyrighted, malicious or illegal source;
contribute constructively to the open data platform in line with the CCRP Code of Conduct;
feedback wherever possible on actual or potential privacy and security concerns;
ensure CCRP open licencing terms are fully adhered to with regard to CCRP open data, CCRP open code and the CCRP Open Manual;
provide as little personal data as possible;
practice, and encourage, the constructive and ethical application of Colouring Cities data and code.

CCRP Protocols for International academic partners

International CCRP partners are responsible for managing individual Colouring Cities platforms, and collaborate with the Alan Turing Institute on core content and code. Each institution signs up to CCRP partner protocols, a mandatory set of decision-making rules, instructions and standards developed by The Alan Turing Institute. These enable academic teams to operate within a clearly defined ethical framework and to work together to meet specific research goals. Protocols are also designed to maximise programme efficiency and effectiveness, ensure prioritisation of the security and well-being of participants, and create an inclusive, stimulating, non-competitive programme environment for researchers focused on interdisciplinary knowledge exchange.

PROTOCOL 1. Governance and ethical standards

Protocol: The Colouring Cities Research Programme (CCRP) is only open to registered research institutions/universities or academic consortia involved in building stock research for the public good. Academic emails are required for all correspondence. The CCRP is overseen by The Alan Turing Institute, the UK's National Institute for Data Science and AI which provides core code, free domain names and coordinates research collaboration. Colouring Cities platforms are independently managed by CCRP academic partners at country level with one academic research institution, or research consortium, leading per country. Set-up of national scale research networks involving academic institutions supporting data upload at regional and local level are also strongly encouraged. Academic partners are responsible for legal oversight of platforms and all aspects of platform content, funding and management. Each partner must provide written confirmation to The Alan Turing Institute of their understanding and acceptance of the CCRP's goals and ethical framework as well as its policies, protocols, codes of conduct and data use agreements.

Justification: CCRP open code released on GitHub may be freely used by anyone under a GNU General Public License. In order to use the code to collect data in a way that promotes responsible data sharing, a trusted data sharing architecture must first be established. The academic governance model offers opportunities to maximise programme quality, efficiency, cost-effectiveness and sustainability and ethical oversight using an existing trustworthy/trusted governance framework. Bringing together specialist academic partners to test code in the context of their research, ensures an ongoing focus on building stock and urban science research as well as data ethics, and clearly differentiates the CCRP from other initiatives using Colouring Cities open code. (Between 2023 and 2025 the CCRP plans to transition towards to a more collaborative governance model). Academic research institutions are also ideal as they are permanent bodies committed to research for the public good, that already meet stringent ethical standards and research protocols and are overseen by national higher education authorities (e.g. see [UK Research Integrity Office] (http://ukrio.org/publications/checklist-for-researchers/). Research institutions also possess the necessary infrastructure to manage platforms and access research grants, and are generally considered by the public to be impartial, trustworthy bodies. They promote rigour and integrity in research; understand that to reach meaningful and reliable conclusions, experimentation and rigorous testing, over time, is required; plan for the long-term, and build on existing research. As such they are ideally placed to manage permanent open databases that need to grow organically with stakeholder input, and improve incrementally to support research goals and promote research integrity and research excellence.

PROTOCOL 2. Transparency and open data

Protocol: CCRP partners commit to releasing all data and code developed within the Colouring Cities programme under specified open licences. Methods are published in the CCRP open manual or in open journals wherever possible. On no account may data or code be charged for or released to specific audiences only. CCRP partners also commit to openness/transparency within the CCRP, to sharing expertise and knowledge wherever possible, and to notifying the Turing of, and crediting the CCRP, on all relevant publications. CCRP partners also commit to publishing up-to-date information on their platform's progress in the CCRP Open Manual.

Justification: The CCRP has been set up to provide open tools that increase access to, and encourage sharing of, data and knowledge in line to support United Nations Sustainable Development Goals. Code, data and methods are therefore released under open data licences. Third party use of data is also permitted to broaden audiences and applications and drive innovation. Openness between CCRP partners is also critical to create a trusted framework for knowledge sharing, and an inclusive, non-competitive and safe research environment necessary for this occur. Publication of updated information through dedicated CCRP academic partner Open Manual pages is also important to allow partners to provide an clear, instant overview of progress/innovation within each participating country, to other CCRP partners, CCRP stakeholders, and the public as a whole. The Open Manual is also important for helping research institutions interested becoming part of the CCRP, to understand requirements, risks and benefits of CCRP membership. Accurate CCRP accreditation is also essential to build trust.

PROTOCOL 3. Citizen security, privacy and well-being

Protocol: CCRP international partners commit to placing the safety, privacy and well-being of platform users, and of building occupiers at the highest level of priority in CCRP platform management and design. Partners must sign up to the CCRP Ethical framework to codes of conduct and to data sharing agreements as well as to specific data collection policies. These include: ensuring that no building attribute data is collected in a freetext format when attached to a building location, that no personal data are collected on users other than email address for security and password resetting purposes, that data on the interior of homes are classified as private with a presumption not to collect (e.g. interior photos) and only non-personal data on structure may be released (i.e number of rooms), and assessing whether a CCRP dataset if combined with one or more other existing or potential datasets could raise security concerns. It is the responsibility of each CCRP academic partner to assess and address any safety and privacy concerns regarding the collection and release of data on CCRP platforms and to inform other CCRP members of these concerns. Risk assessment must take account of government and university data ethics policies and legal frameworks. Risk assessments made by the Alan Turing Institute are indicative only. Where risks have been identified by a platform host all CCRP partners must be notified where applicable to others and mitigation strategies implemented. Where risks cannot be eliminated, or reduced to acceptable levels, data may not be openly released on CCRP platforms, regardless of whether or not these have been released by data owners (including government) into the public domain.

Justification: Prioritisation of the privacy and security of citizens should be the default position of any data initiative. Risk assessment regarding the release of data is also critical. In CCRP platforms the security and privacy of both platform users and building occupants must be considered because of the use of location data. Specific CCRP policies therefore exist with regard to the kind of data permitted for collection and the format in which these are released. Further information on these can be found in the Open Manual's 'Ethical Framework' and 'Data' sections.

PROTOCOL 4. Purpose limitation

Protocol: CCRP platforms may only collect data identified as relevant to the improvement of the quality, efficiency, sustainability and resilience of building stocks. Each dataset must assessed for relevance and security and privacy issues prior to being included.

Justification: The CCRP is a research-led initiative with specific research goals. As such there is close control of the type of data collected. To date decisions of data categories to be collected have been made by The Alan Turing Institute (and previously by UCL where the project originated). The move in 2022 to a core code repository is allowing for more collaborative decision making between CCRP international experts on new types of data to be collected, relevant to all countries.

PROTOCOL 5. Platform and data quality

Protocol: CCRP academic partners commit to creating platforms and databases containing the highest quality data possible on the composition, operation and dynamic behaviour of building stocks, to help improve stock quality, efficiency, sustainability and resilience and to meet United Nations' Sustainable Development Goals. CCRP platform hosting is open to academic faculties/departments willing and able to combine built environment and research software engineering expertise. Built environment expertise may relate to housing, planning, heritage/building history, architecture/building design, building construction, building performance, building lifespans/survival rates and urban metabolism, building energy use and retrofit, and/or building related disaster management. Academic teams commit to encouraging multidisciplinary work, and must be led by those with experience, or an interest in improving knowledge exchange on stocks across sectors and disciplines, in working across science and technology, humanities and the arts, and in widening stakeholder engagement. CCRP partners commit to testing at least four methods of open data capture - open bulk upload, crowdsourcing, live streaming of official data, and computational approaches (and feedback loops between these) -, to including and testing as many methods of data verification as possible, and to creating inclusive, collaborative maintenance systems that encourage diverse knowledge holders to become involved.

Justification: Successful co-working of building stock experts, data scientists and research software engineers is key to the success of Colouring Cities platforms. An interest and commitment to diverse stakeholder engagement is also critical as information on stocks is highly fragmented and voluntary contributions from diverse experts/stakeholder are needed to improve data quality, coverage and richness. Expert knowledge of the stock, and its physical form, is essential within departments running platforms, as platforms support not only high quality visual databases but also operate as research tools. Testing the value of these tools, and promoting knowledge exchange across subjects, sectors and fields comprise core elements of the programme and require specialist input. Bringing together academics and research departments working on diverse areas of building related research also facilities collective problem solving and helps identify the value of data for specific applications. Four data capture methods are tested each of which have been incorporated to improve data quality and coverage, and address diverse stakeholder needs.

PROTOCOL 6. Prototype testing and platform interoperability

Protocol: CCRP international partners commit to collaborating with The Alan Turing Institute, and other CCRP members, to reproduce, test, and co-work on Colouring Cities open-source code, with a view to creating a global network of interoperable Colouring Cities platforms. These will enable comparison of data across countries, and provide the scale of data necessary to gain global insights into stock operation through the responsible use of AI and machine learning. CCCP partners commit to using identical interfaces, main data category keypads, data formatting and similar subcategory wording. This is required to maximise clarity and to ensure core data categories are standardised to ensure data may be easily shared. Platforms may differ in the inclusion of specific subcategories relevant to the national/regional local context. Core repository code is overseen by the Alan Turing Institute and is contributed to by CCRP partners. Country specific code must be openly shared through academic partners' individual Colouring Cities GitHub repositories.

Justification: The CCRP has been set up as a branded academic research programme and tests the value of the Colouring Cities model both in research, and as a publicly accessible resource. Consistency across platforms of data subcategories and data formatting is critical to support comparative analysis of data across countries, and international collaboration. Once large-scale datasets for similar data subcategories have been captured across countries, a variety of approaches, including the application of AI and machine learning, can be used to gain insights into macro and microscale patterns. The CCRP provides a unique space in which international groups can informally co-design and test demonstration platforms to the highest standards, explore the potential value of release of building attribute data (at 'cell' level) within diverse applications, and share thoughts on ethical issues.

PROTOCOL 7. Sustainable management, funding and legal disclaimers

Protocol: CCRP partners commit to setting up platforms with a view to permanent use. It is the responsibility of all CCRP partners to fund and manage their own platforms and ensure that the correct open licences are used. CCRP platforms are not-for-profit and are only designed to secure funds for use in research that directly advances the CCRP's goals for the public good. CCRP partners commit to ensuring that all platform content has been checked to the satisfaction of their legal departments. Platform users and stakeholders must be made aware, explicitly, through the platform, that it is their responsibility to check the quality and suitability and of data for their specific purpose (e.g. academic paper, policy document, school project). Disclaimers must therefore be included to ensure that that individual research institutions cannot be held liable for data inaccuracies, or for the way in which the CCRP data are applied. It is the responsibility of the institution and its legal team to make itself fully aware of any risks and responsibilities relating to data platform management and data release, and to have strategies to address these in place (See also Governance/risks). Where relevant to other CCRP partners, information on identified risks should be shared. Platforms are required to be managed as agile, experimental systems able to exploit technical advances over time to ensure continued usefulness and accessibility. Partners commit to minimising energy wastage, knowledge wastage, and platform costs and to collaborative maintenance of databases with stakeholder groups. Ongoing commitment to fundraising and maintenance is essential.

Justification: To maximise the potential for efficiency and sustainability, Colouring Cities platforms need to be viewed as permanent resources that are built on and improved year on year. This is a reasonable expectation as building attribute data will always be necessary in the design, construction, management and maintenance of cities and their stocks (e.g in the management of housing supply, improvement of construction quality, development of policies for urban planning, energy monitoring, building retrofit and conservation etc.) as well as in many related areas of academic research. Stocks are also a society's most valuable physical asset, with the quality of buildings impacting on all citizens' lives. Critical to the success of the programme is the development of an understanding that the highest quality databases on stocks can only be achieved through whole-of society approach to data input, and through collectively responsibility for making these as accurate as possible and being transparent about sources and data capture methods, and through incremental improvement over time. Though the size of CCRP partner teams will vary by country, the aim is to test a low-cost model that can be run by institutions and seamlessly integrated into their research. Owing to the interdisciplinary nature of the programme, diverse funding routes will be open to academic hosts. These will need to be exploited to generate an effective collaborative maintenance structure to maximise data richness and verification.

PROTOCOL 8. Conduct, equality, diversity and inclusion

Protocol: CCRP partners commit to creating and maintaining a non-competitive, collaborative, respectful working environment and to adhering to the Colouring Cities Code of conduct. Diversity in CCRP teams, in terms of gender, skills and abilities, and cultural background, are strongly encouraged. CCRP partners also commit to maximising inclusivity of platforms in terms of diversity of audiences and contributors.

Justification: Central to all CCRP work is a recognition of the importance of: a) kind and considerate treatment of others, and of the knowledge they have, b) respect for, and recognition of the importance of input from diverse audiences into CCRP databases and c) prioritisation of the privacy and security of CCRP data contributors, occupiers/owners of buildings, and the well-being of CCRP teams.

PROTOCOL 9. Democratic principles and processes, human rights and intellectual independence

Protocol: CCRP academic partners commit to the promotion of democratic principles and processes through the collection, visualisation and sharing and release of open building attribute data through CCRP platforms, to promoting human rights, and to supporting spatial justice.

CCRP academic partners also commit to intellectual independence, including from government, irrespective of the sources and scale of funding provided. They also commit to ensuring that individual commercial interests are not promoted. The CCRP reserves the right to remove data provided by 3rd parties where there are ethical concerns.

Justification: The CCRP has been set up to support UN Sustainable development Goals, promote democratic principles and processes and advance and support human rights and spatial justice. The integrity and independence of academic institutions is critical to the CCRP programme and to public trust in it. It is also essential that funding contributions cannot be used to influence platform content or CCRP research goals or to alter the balance of focus on categories of data collected. Commercial organisations are encouraged to increase their profile on the platform in the following ways: name included as the source of a data entry; number of edits recorded on the Leaderboard; accreditation of significant voluntary time/resources credited on the Who's Involved page.

PROTOCOL 10. Meeting attendance and updating Manual pages

Protocol: CCRP partners commit to attendance at bimonthly CCRP research meetings, and to updating Turing/partners on progress where requested. Partners are asked to supply a single slide in advance of each meeting, providing a summary of progress, and to also update their individual country pages on the Open Manual on GitHub. In circumstances where PI attendance is not possible, CCRP teams commit to informing Turing and providing other academic representation where available. Meetings are limited to core teams to allow for detailed strategic discussions, though requests for guest access for presentations may be made. Regular software engineering meetings are also co-ordinated by The Alan Turing Institute to facilitate knowledge sharing across engineering teams. Format and content of meetings are open to discussion.

Justification: The CCRP is a collaborative initiative in which partners commit to co-working on Colouring Cities code and content, and supporting and sharing knowledge and expertise with other CCRP partners. Attendance at regular meetings is critical for identifying significant /potential problems, deciding on the most efficient ways in which these can be solved, co-working on code and sharing findings and ideas. Up-to-date information on the Open Manual means that all partners and potential collaborators are aware of progress across the group. This information can be used to support existing and new partners when justifying requests for funding. Attendance and prompt responses to information requests also helps reduce costs of /time needed for CCRP administration by the Turing, freeing up more time for discussion and research.

PROTOCOL 11. Resource access and sharing

Protocol: CCRP partners commit to respectful use of CCRP resources provided by the Alan Turing Institute. These include CCRP meetings, one-to-one sessions, open manual CCRP country page editing access, acknowledgement of partners on the Turing website, shared information on relevant grants and papers, use of the Colouring cities logo, and use of the CCRP domain name free of charge. Partners are expected to work independently and are fully responsible for all costs arising from their platforms, including server costs. Co-working across international technical teams is strongly encouraged to share as much technical knowledge as possible as well as to help reduce individual countries' technical costs.

Justification: The Alan Turing Institute looks to provide as much free support as possible to CCRP partners, however the amount of support available is constrained by its budget. Programme partners are expected to support Turing in minimising CCRP admin time. Software engineering teams are expensive to run and teams often difficult to sustain for long periods. Pooling technical expertise and PI/Institution knowledge helps increase platform quality and sustainability.

PROTOCOL 12. Partner withdrawal/removal from the programme

Protocol. CCRP partners are entitled to withdraw from the CCRP at any point and to continue work on their platforms outside the programme. This may occur where partners feel CCRP' protocols constrain their work. One month's notice is requested. In such a situation a CCRP partner must cease using the Colouring Cities name and logo and relinquish access to free CCRP resources listed above. In the unlikely event that CCRP protocols are consciously breached (or are unconsciously breached and remain unrectified) The Alan Turing Institute reserves the right to remove institutions from the programme and website, along with resources and support. Where no representation has been made by a CCRP partner for 3 consecutive CCRP meetings, contact not made with Turing for over 6 months, and/or Open Manual pages and live sites have not been updated it may be presumed by the Turing that the partner institution no longer wishes to be part of the CCRP and details may be removed from the international partner list and partner pages at the Turing's discretion.

Justification: An exit strategy minimising knowledge/data loss is required for CCRP partners wishing to withdraw from the programme for any reason. To help maintain quality, mechanisms are needed to allow for the removal of partners if protocols are breached or ignored. The CCRP also needs to target CCRP resources at active and future partners working collectively towards common goals, to ensure that the quality of the Colouring Cities brand is upheld, and to ensure that inactive Colouring Cities platforms do not exist in name only.

CCRP protocols for Academic Streeing group Members Global Region coordinators

CCRP Global Region Hubs (GRHs) are being set up to address the growth in interest from international academic institutions in testing CCRP code, and to increase the efficiency and effectiveness of the programme. CCRP Global regions are at present defined as below. (As the number of participating countries increases hubs will be subdivided as necessary. The CCRP is particularly grateful to Professor Chris Pettit and Dr Matt Ng at the University of New South Wales, and Dr Fernando Benitez at the University of St Andrew's for their support in Hub network set up)

CCRP Asia Pacific (Central & South Asia, Northeastern Asia, Southeastern Asia, Australia and Oceania)
CCRP Europe
CCRP Middle East
CCRP Africa
CCRP Americas (North America, South America, Central America, Caribbean)

PROTOCOL 1: Co-ordinator appointment

CCRP academic partners wishing to lead or co-lead CCRP Global Region Hubs must already be a CCRP academic partner with at least one year's engagement in the program and must be running an operational CCRP platform. Co-ordination leads are voluntary positions. Contact details are provided on the Colouring Cities website.

PROTOCOL 2: Updates and meetings

CCRP Global Region Hub coordinators agree to co-work with the Alan Turing Institute and co-host set-up quarterly meetings. Coordinators also commit to regularly updating the Turing on progress;

PROTOCOL 3: Oversight

CCRP Global Region Hub coordinators facilitate discussions between academic partners on areas such as content, quality, standards, applications, ethics, protocols, design, grants and papers. Their role is also to help academic institutions to come on board, and to highlight any issues or risks arising. Co-ordinators are not responsible for the management or performance of individual platforms; this lies wholly with individual academic partners who are required to sign up to CCRP partner protocols.

PROTOCOL 4: Publications

CCRP Global Region Hub coordinators agree to notify The Alan Turing Institute of all proposed joint publications and to ensure that the CCRP and the Alan Turing Institute are correctly acknowledged within these.

CCRP Guidelines for National Academic Data Upload Hub Networks

In order to accelerate data upload, improve data quality and maximise information to allow assessment of data reliability, the CCRP also tests a research-led data moderation model, operating at country level and regional scale. This helps academic consortia to support stakeholder engagement and data moderation of large-scale building attribute datasets in such a way as to support researchers and students, enhance/enrich existing programmes, attract new funding and drive new cross disciplinary research. Protocols for regional hosts for CCRP national academic partners are as follows:

GUIDELINE 1: Eligibility

CCRP Data Upload Hubs are designed to be made up of a consortia of academic institutions. It is recommended that network partners sign up to CCRP Data Upload Hub protocols and code registered academic institutions signing hubs are academic leads coordinators/ city CCRP coordinators must be academic institutions registered with national higher education authorities.

GUIDELINE 2: Ethics

As with international platform hosts, academic partners involved in CCRP Data Upload Hubs must sign up to the CCRP's ethical framework, Code of Conduct and Contributor & Data User's Data Accuracy & Ethical Use Agreement.

GUIDELINE 3: Data upload and quality improvement

Regional academic partners involved in CCRP Data Upload Hubs provide voluntary support to CCRP platform hosts by moderating and helping upload bulk datasets, helping engage stakeholders at regional and local level, and working to maximise data coverage and quality.

Click herefor more information on the CCRP's ethical framework.