{"id":20234931,"url":"https://github.com/datamade/django-pldp","last_synced_at":"2025-09-22T05:32:34.634Z","repository":{"id":53050049,"uuid":"159738360","full_name":"datamade/django-pldp","owner":"datamade","description":"Reusable Django app that implements data models for PLDP","archived":false,"fork":false,"pushed_at":"2023-04-28T14:36:12.000Z","size":634,"stargazers_count":3,"open_issues_count":4,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-14T08:13:47.182Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/datamade.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-11-29T23:00:19.000Z","updated_at":"2024-11-06T00:20:57.000Z","dependencies_parsed_at":"2022-09-09T18:53:40.418Z","dependency_job_id":null,"html_url":"https://github.com/datamade/django-pldp","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datamade%2Fdjango-pldp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datamade%2Fdjango-pldp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datamade%2Fdjango-pldp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datamade%2Fdjango-pldp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/datamade","download_url":"https://codeload.github.com/datamade/django-pldp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233828176,"owners_count":18736578,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-14T08:13:50.076Z","updated_at":"2025-09-22T05:32:29.277Z","avatar_url":"https://github.com/datamade.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# django-pldp\n\n🌳 A reusable Django app implementing the Gehl Institute's [Public Life Data Protocol](https://gehlinstitute.org/tool/public-life-data-protocol/).\n\n## Philosophical underpinnings\n\nFrom the [Gehl Institute](https://gehlinstitute.org/):\n\n\u003e The Public Life Data Protocol (the Protocol) describes a set of metrics that\n\u003e are important to the understanding of public life—people moving and staying\n\u003e in public space—and aims to establish a common format for the collection and\n\u003e storage of such data. Used in conjunction with the Public Life Data Tools or\n\u003e other observational methods for collecting data about people in public space,\n\u003e the Protocol provides the structure for the data you collect.\n\n\u003e Based on four decades of research and application of data about public life\n\u003e to shape public policy, planning, and urban design, the Protocol is an open\n\u003e data specification intended to improve the ability of everyone to share and\n\u003e compare information about public life activity in public space. In recent\n\u003e years, practitioners and cities have incorporated people-centered metrics and\n\u003e public life data into their engineering models, investment decisions, and\n\u003e design choices. These methods, based on decades of research, have now been\n\u003e applied in hundreds of cities around the world. There is tremendous potential\n\u003e to make public life datasets more compatible, scalable, and comparable across\n\u003e different cities and regions.\n\nThe PLDP describes 3 different modes of collecting observational survey data:\n\n1. Linked surveys: Collecting many pieces of information at the same time\n   about the same respondents.\n2. Simultaneous surveys: Collecting many pieces of information at the same\n   time but not about the same respondents.\n3. Consecutive surveys: Collecting many pieces of information at different\n   times from different respondents.\n\nSurveys should always have a Study and Location in common. A Survey in the\nfirst mode has a collection of SurveyComponents that share a SurveyRow.\nA Survey in the second mode can have a collection of SurveyComponents but they\nwill each be in separate SurveyRow. The third mode suggests entirely disjoint\ncollection efforts that merely have a Location in common.\n\nThis implementation of the PLDP is based on the September 2017 Beta release. The Gehl\nInstitute's full documentation of the protocol can be found [here](pldp-source-documents/PLDP_BETA%20Publication%20-%2020170927.pdf).\n\n## Adding `django-pldp` to your project (NB: this needs work)\n\n1. Add django-pldp to the installed apps in your project's settings.py file:\n\n```python\nINSTALLED_APPS = (\n    ...\n    'countries_plus',\n    'languages_plus',\n    'pldp',\n)\n```\n\n4. Update migrations:\n\n`python manage.py migrate`\n\n5. Load in necessary fixtures from `django-pldp`:\n\n```\npython manage.py initialize_pldp\n```\n\nYou should now be able to use `django-pldp` in your project!\n\n## Developing `django-pldp` locally\n\n1. Clone this repository and `cd` into your local copy.\n\n    ```bash\n    git clone git@github.com:datamade/django-pldp.git\n    cd django-pldp\n    ```\n\n2. Create a virtual environment. (We recommend using [`virtualenvwrapper`](http://virtualenvwrapper.readthedocs.org/en/latest/install.html) for working in a virtualized development environment.)\n\n    ```bash\n    mkvirtualenv -p python3 pldp\n    ```\n\n3. Install the requirements.\n\n    ```bash\n    pip install -r pldp/requirements.txt\n    ```\n\n4. Export the Django settings:\n\n    ```bash\n    export DJANGO_SETTINGS_MODULE=tests.test_config\n    ```\n\n4. Create a database:\n\n    ```bash\n    createdb pldp\n    ```\n\n5. Run migrations:\n\n    ```bash\n    django-admin migrate\n    ```\n\n## Team\n\n-   [Bea Malsky](https://github.com/beamalsky)\n-   [Regina Compton](https://github.com/reginafcompton)\n-   [Eric van Zanten](https://github.com/evz)\n\n\n## Copyright\n\nCopyright (c) 2019 University City District and DataMade.\nReleased under the [MIT\nLicense](https://github.com/datamade/django-councilmatic/blob/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatamade%2Fdjango-pldp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatamade%2Fdjango-pldp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatamade%2Fdjango-pldp/lists"}