{"id":15913178,"url":"https://github.com/34j/lab-student-survey","last_synced_at":"2025-03-22T19:34:42.561Z","repository":{"id":195988059,"uuid":"693924543","full_name":"34j/lab-student-survey","owner":"34j","description":"Python package for lab student survey. A single command fetches the spreadsheet generated from Google Forms and uploads the analysis results to Google Drive. Automatically calculates mean, standard deviation, correlation coefficient, p-value, Cronbach's alpha, and performs cluster analysis.","archived":false,"fork":false,"pushed_at":"2024-10-21T17:08:40.000Z","size":244,"stargazers_count":1,"open_issues_count":12,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-22T06:41:24.734Z","etag":null,"topics":["analysis","google-cloud-platform","google-drive","google-drive-api","google-forms","google-sheets","html","lab","laboratory","pdf","pi","python","rate","rating","review","service-account","survey","university"],"latest_commit_sha":null,"homepage":"","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/34j.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["34j"]}},"created_at":"2023-09-20T01:46:52.000Z","updated_at":"2024-08-19T20:47:56.000Z","dependencies_parsed_at":"2023-11-09T11:57:04.317Z","dependency_job_id":"cc77f9c8-715f-4833-8e20-118cf0feaeeb","html_url":"https://github.com/34j/lab-student-survey","commit_stats":null,"previous_names":["34j/lab-student-survey"],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/34j%2Flab-student-survey","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/34j%2Flab-student-survey/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/34j%2Flab-student-survey/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/34j%2Flab-student-survey/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/34j","download_url":"https://codeload.github.com/34j/lab-student-survey/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221837110,"owners_count":16889207,"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":["analysis","google-cloud-platform","google-drive","google-drive-api","google-forms","google-sheets","html","lab","laboratory","pdf","pi","python","rate","rating","review","service-account","survey","university"],"created_at":"2024-10-06T16:23:24.762Z","updated_at":"2024-10-28T14:05:37.817Z","avatar_url":"https://github.com/34j.png","language":"Python","funding_links":["https://github.com/sponsors/34j"],"categories":[],"sub_categories":[],"readme":"# Lab Student Survey\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/34j/lab-student-survey/actions/workflows/ci.yml?query=branch%3Amain\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/34j/lab-student-survey/ci.yml?branch=main\u0026label=CI\u0026logo=github\u0026style=flat-square\" alt=\"CI Status\" \u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://lab-student-survey.readthedocs.io\"\u003e\n    \u003cimg src=\"https://img.shields.io/readthedocs/lab-student-survey.svg?logo=read-the-docs\u0026logoColor=fff\u0026style=flat-square\" alt=\"Documentation Status\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://codecov.io/gh/34j/lab-student-survey\"\u003e\n    \u003cimg src=\"https://img.shields.io/codecov/c/github/34j/lab-student-survey.svg?logo=codecov\u0026logoColor=fff\u0026style=flat-square\" alt=\"Test coverage percentage\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://python-poetry.org/\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/packaging-poetry-299bd7?style=flat-square\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAASCAYAAABrXO8xAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAJJSURBVHgBfZLPa1NBEMe/s7tNXoxW1KJQKaUHkXhQvHgW6UHQQ09CBS/6V3hKc/AP8CqCrUcpmop3Cx48eDB4yEECjVQrlZb80CRN8t6OM/teagVxYZi38+Yz853dJbzoMV3MM8cJUcLMSUKIE8AzQ2PieZzFxEJOHMOgMQQ+dUgSAckNXhapU/NMhDSWLs1B24A8sO1xrN4NECkcAC9ASkiIJc6k5TRiUDPhnyMMdhKc+Zx19l6SgyeW76BEONY9exVQMzKExGKwwPsCzza7KGSSWRWEQhyEaDXp6ZHEr416ygbiKYOd7TEWvvcQIeusHYMJGhTwF9y7sGnSwaWyFAiyoxzqW0PM/RjghPxF2pWReAowTEXnDh0xgcLs8l2YQmOrj3N7ByiqEoH0cARs4u78WgAVkoEDIDoOi3AkcLOHU60RIg5wC4ZuTC7FaHKQm8Hq1fQuSOBvX/sodmNJSB5geaF5CPIkUeecdMxieoRO5jz9bheL6/tXjrwCyX/UYBUcjCaWHljx1xiX6z9xEjkYAzbGVnB8pvLmyXm9ep+W8CmsSHQQY77Zx1zboxAV0w7ybMhQmfqdmmw3nEp1I0Z+FGO6M8LZdoyZnuzzBdjISicKRnpxzI9fPb+0oYXsNdyi+d3h9bm9MWYHFtPeIZfLwzmFDKy1ai3p+PDls1Llz4yyFpferxjnyjJDSEy9CaCx5m2cJPerq6Xm34eTrZt3PqxYO1XOwDYZrFlH1fWnpU38Y9HRze3lj0vOujZcXKuuXm3jP+s3KbZVra7y2EAAAAAASUVORK5CYII=\" alt=\"Poetry\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/ambv/black\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square\" alt=\"black\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/pre-commit/pre-commit\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\u0026logoColor=white\u0026style=flat-square\" alt=\"pre-commit\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://pypi.org/project/lab-student-survey/\"\u003e\n    \u003cimg src=\"https://img.shields.io/pypi/v/lab-student-survey.svg?logo=python\u0026logoColor=fff\u0026style=flat-square\" alt=\"PyPI Version\"\u003e\n  \u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/pypi/pyversions/lab-student-survey.svg?style=flat-square\u0026logo=python\u0026amp;logoColor=fff\" alt=\"Supported Python versions\"\u003e\n  \u003cimg src=\"https://img.shields.io/pypi/l/lab-student-survey.svg?style=flat-square\" alt=\"License\"\u003e\n\u003c/p\u003e\n\nPython package for lab student survey.\nA single command fetches the spreadsheet generated from Google Forms and uploads the analysis results to Google Drive.\n\n## Usage\n\n- Create `student-lab-survey` (or any name) project in Google Cloud Platform.\n- Enable `Google Drive API` in Google Cloud Platform.\n- Create a `Service Account` in Google Cloud Platform.\n- Download the `Service Account` credentials as JSON in Google Cloud Platform and save it as `service-secrets.json` in the working directory or set it as `GDRIVE_SERVICE_ACCOUNT` environment variable (via GitHub Secrets).\n- Create `student-lab-survey` (or any name) folder in Google Drive.\n- Add the `Service Account` email to the `student-lab-survey` folder with `Editor` permissions.\n- Create a `Google Form` for the lab student survey. The second question should be the name of the supervisor.\n- Create a `Google Sheet` in the `student-lab-survey` folder from the `Google Form`.\n- Create `metadata.csv` and `metadata_group_name.csv` in the working directory or `student-lab-survey` folder in Google Drive to specify the question groups. The former will be automatically generated in the working directory if it does not exist. The latter is optional.\n\n### Environment Variables\n\n- Set the `Google Sheet` ID as `LAB_STUDENT_SURVEY_FILE_ID` environment variable (via GitHub Secrets).\n- Set the `student-lab-survey` folder ID as `LAB_STUDENT_SURVEY_FOLDER_ID` environment variable (via GitHub Secrets). (Optional.) If not set, the parent folder ID of the `Google Sheet` will be used.\n- (Set the `Service Account` credentials as `GDRIVE_SERVICE_ACCOUNT` environment variable (via GitHub Secrets).)\n\n### Running commands\n\n```shell\nlss\n```\n\n### Github Actions\n\n```yaml\nname: Run lab-student-survey\n\non:\n  schedule:\n    # every day at 00:00 UTC\n    - cron: \"0 0 * * *\"\n  workflow_dispatch:\n\njobs:\n  run:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v3\n      - name: Install wkhtmltopdf\n        run: sudo apt-get install -y wkhtmltopdf\n      - name: Install and run lab-student-survey\n        run: pipx run lab-student-survey\n        env:\n          LAB_STUDENT_SURVEY_FILE_URL: ${{ secrets.LAB_STUDENT_SURVEY_FILE_URL }}\n          LAB_STUDENT_SURVEY_FOLDER_URL: ${{ secrets.LAB_STUDENT_SURVEY_FOLDER_URL }}\n          GDRIVE_SERVICE_SECRETS: ${{ secrets.GDRIVE_SERVICE_SECRETS }}\n```\n\n## Installation\n\nInstall this via pip or pipx (or your favourite package manager):\n\n```shell\npipx install lab-student-survey\n```\n\n## Alternatives\n\nAs far as I could find, there is no repository on GitHub for this particular topic. Instead, you may want to check out the following alternative websites. However, as there are too few people in a lab, with the effect of diminishing anonymity, most of these websites do not seem to attract many reviews.\n\n### 国内\n\n- [理系研究室のクチコミサイト｜OpenLab](https://openlabmg.com/): **募集停止中**, 投稿するとAmazonギフト券（100円）がもらえる, ほとんど情報なし(100程度?)\n- [LabBase 研究室サーチ](https://lab-search.app.labbase.jp/): **入力方法不明**, 上よりも情報なし\n- [研究室ナビ](http://kenkyu-navi.com): リンク切れ [Forms](https://docs.google.com/forms/d/1s-c8tGOCGLv35KimBo9U7d3MKPyXpDl_QcHLozppAgM/viewform?edit_requested=true)\n\n[研究室　口コミ \\-満載 \\-学べます \\- Search / X](https://twitter.com/search?q=%E7%A0%94%E7%A9%B6%E5%AE%A4%E3%80%80%E5%8F%A3%E3%82%B3%E3%83%9F%20-%E6%BA%80%E8%BC%89%20-%E5%AD%A6%E3%81%B9%E3%81%BE%E3%81%99)\n\n### 海外\n\n- [PI Review](https://pi-review.com/): 231 reviews (2021/09/21)\n- [GradPI](https://www.gradpi.com/): 329 reviews (2023/09/21), Must have a .edu or .ac.uk domain email address to even view the site.\n- [RMGA](https://ratemygradadvisor.com/): 3 reviews? (2021/09/21)\n- ratemypi.com, qcist.com: リンク切れ\n- [한국에너지공과대학교 에너지공학부 구근호 \\- 김박사넷](https://phdkim.net/professor/9877/info): かなり多い(1000以上?)\n\n[pi rate website phd site:www\\.reddit\\.com \\- Google Search](https://www.google.com/search?q=pi+rate+website+phd)\n\n## Contributors ✨\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003c!-- markdownlint-enable --\u003e\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F34j%2Flab-student-survey","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F34j%2Flab-student-survey","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F34j%2Flab-student-survey/lists"}