balance-in-place-toolkit

Balance in Place Toolkit — Five Elements for CPTED (S-FE Toolkit): audit, QGIS quick-steps, SLA templates.

Balance in Place Toolkit — Five Elements for CPTED (Balance Toolkit) — v0.1

Practical toolkit & service-level pack to run short CPTED + NbS trials informed by Five Elements (Feng Shui).
A municipal-ready set of templates, QGIS steps, monitoring CSVs, a one-page audit, and an SLA template to pilot, evaluate, and convert small public-space interventions into procurement decisions.

---

Short description

This toolkit translates Five Elements / Feng Shui heuristics into measurable GIS indicators and step-by-step protocols for low-cost, reversible interventions (planters, lighting, seating, drainage). It is designed for municipal officers, NGOs, urban designers, and students to run 1-week pilots, collect simple KPIs, and make defensible Keep/Move/Remove decisions using an SLA-driven approach. For the following files, the toolkit takes Scampia, Naples, Italy, as an example.

This release: v0.1 — initial public release .
DOI / Citation: DOI:10.5281/zenodo.17011561 .

Suggested citation
Dai, Yingdi (2025). Balance in Place Toolkit — Five Elements for CPTED (Balance Toolkit) v0.1. Zenodo. DOI:10.5281/zenodo.17011560

---

What’s included

• README.md — this file.
• Balance_in_Place_Toolkit_v0.1.zip — release bundle.
• Balance_in_Place_Manuscript.docx / .pdf — practice article.
• Toolkit_appendix.pdf — one-page CPTED audit checklist.
• Operationalisation_matrix.pdf / .docx — Five Elements → Indicators → Moves → SLA.
• SLA_template.pdf / .docx — one-page SLA template.
• templates/ — tally_template.csv, intercept_template.csv, scoring_rubric.xlsx.
• qgis/scampia_qgis_project.qgz.
• figures/ — operational matrix PNG, annotated map PNG, example_sla_table PNG, workflow_pipeline PNG.
• references_apa.pdf.
• HOWTO.md, CHANGELOG.md, LICENSES/.

---

Quick start — run a 1-week pilot (3–5 steps)

1. Unzip the release and open qgis/scampia_qgis_project.qgz (or follow qgis_README.md to download base layers).
2. Diagnose (1 day): run viewshed/LOS; compute shaded_path_pct (see HOWTO.md); fill tally_template.csv.
3. Co-design (90 min): run a short workshop using scampia_toolkit_appendix.pdf and operationalisation_matrix.pdf.
4. Pilot (1–3 days): install reversible measures (planters, solar bollards, seating). Log costs in KPI_dashboard_example.csv.
5. Monitor & decide (1 week): collect 15-min tallies; fill intercepts; apply scoring_rubric.xlsx; use SLA_template.pdf thresholds to Keep/Adjust/Remove.

See HOWTO.md for step-by-step commands.

---

Dependencies & environment

• QGIS >= 3.22 (recommended)
• Spreadsheet software (Excel, LibreOffice)
• Optional: browser for WebAR overlays

---

Ethics & data

• All sample data included are anonymised or illustrative.
• Obtain written consent before publishing photos or direct quotes (consent_templates/participant_consent.docx).
• Do not redistribute proprietary base layers; follow qgis_README.md to recreate them.

---

License

• Documents & templates: Creative Commons Attribution 4.0 International (CC-BY-4.0)
• Code/scripts: MIT
  (See LICENSES/ for full texts.)

---

Authoritative citation

Dai, Yingdi. (2025). Balance in Place Toolkit — Five Elements for CPTED (Balance Toolkit) v0.1. Zenodo. https://doi.org/10.5281/zenodo.17011561

How to contribute / report issues

• Open an issue on the GitHub repository or send pull requests.
• Contact: Yingdi Dai — yingdidai.dyd@.gmail.com

---

References

See references_apa.pdf for the toolkit bibliography (key readings: Cozens & Love 2015; Tzoulas et al. 2007; Hong et al. 2007). A related conference paper emphasized service standards; this article presents a distinct method workflow and new figures.

Last updated: 2025-8-31