{"id":29569807,"url":"https://github.com/nmfs-ost/aa-si_gpcsetup","last_synced_at":"2025-07-19T02:07:03.707Z","repository":{"id":296277850,"uuid":"992828855","full_name":"nmfs-ost/AA-SI_GPCSetup","owner":"nmfs-ost","description":"A startup script that sets up new users and environments with AA-SI tools and resources.","archived":false,"fork":false,"pushed_at":"2025-07-07T20:42:24.000Z","size":1323,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-07T23:57:08.421Z","etag":null,"topics":["acoustics","authentication","automation-scripts","linux","packages","permissions","setup-script"],"latest_commit_sha":null,"homepage":"https://nmfs-ost.github.io/AA-SI_PublicPage/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nmfs-ost.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-29T19:24:27.000Z","updated_at":"2025-07-07T20:42:27.000Z","dependencies_parsed_at":"2025-05-29T21:20:02.374Z","dependency_job_id":"5fd24b06-7fd4-48f0-9624-5e261a4f6eaf","html_url":"https://github.com/nmfs-ost/AA-SI_GPCSetup","commit_stats":null,"previous_names":["nmfs-ost/aa-si_gpcsetup"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nmfs-ost/AA-SI_GPCSetup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmfs-ost%2FAA-SI_GPCSetup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmfs-ost%2FAA-SI_GPCSetup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmfs-ost%2FAA-SI_GPCSetup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmfs-ost%2FAA-SI_GPCSetup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nmfs-ost","download_url":"https://codeload.github.com/nmfs-ost/AA-SI_GPCSetup/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmfs-ost%2FAA-SI_GPCSetup/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265872671,"owners_count":23842235,"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":["acoustics","authentication","automation-scripts","linux","packages","permissions","setup-script"],"created_at":"2025-07-19T02:06:59.222Z","updated_at":"2025-07-19T02:07:03.695Z","avatar_url":"https://github.com/nmfs-ost.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📘 GCP Workstation Setup Guide: **AA-SI Environment**\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/logo.png\" alt=\"Project Logo\" width=\"70%\"\u003e\n\u003c/p\u003e\n\nThis guide provides step-by-step instructions to set up a Google Cloud Platform (GCP) Workstation for use with the **AA-SI (Advanced Acoustics - Scientific Integration)** toolset.\n\n---\n\n## ➊ Setup Prerequisites\n\nThis setup assumes:\n\n1. You maintain a NOAA Gmail account.\n2. You are authorized to deploy GCP Workstations hosted by NMFS - Office of Science and Technology. If you do not have this set up navigate to : [https://github.com/enterprises/noaa-nmfs](https://github.com/enterprises/noaa-nmfs)\n\n---\n\n## ➋ GCP Workstation Configuration\n\n### 1. Navigate to GCP Workstations Console\n\nOpen your browser and go to: [https://console.cloud.google.com/workstations/overview](https://console.cloud.google.com/workstations/overview)\n\n---\n\n### 2. Create a Workstation\n\nUse the interface to configure and deploy a new workstation:\n\n![Create Workstation](assets/instruction_4.png)\n\n### 3. Choose name, display name and jupyter Lab configuration\n\n\n![Create Workstation](assets/instruction_6.png)\n\n---\n\n### 4. Launch the Workstation\n\nOnce your workstation is created, launch it:\n\n![Launch Workstation](assets/instruction_5.png)\n\n---\n\n### 5. Open the Terminal\n\nStart a terminal session within your running GCP workstation:\n\n![Open Terminal](assets/instruction_2.png)\n\n---\n\n## ➌ Environment Initialization\n\n### 5. Run Initialization Script\n\nThis script will:\n\n- Download and run the AA-SI setup script\n- Assign execution permissions\n- Activate the Python virtual environment\n- Start GCP authentication\n\nPaste the following into your terminal:\n\n```bash\ncd /opt \u0026\u0026 \\\nsudo rm -f init.sh \u0026\u0026 \\\nsudo wget https://raw.githubusercontent.com/nmfs-ost/AA-SI_GPCSetup/main/init.sh \u0026\u0026 \\\nsudo chmod +x init.sh \u0026\u0026 \\\n./init.sh \u0026\u0026 \\\ncd ~ \u0026\u0026 \\\nsource aa_si/bin/activate \u0026\u0026 \\\ngcloud auth application-default login \u0026\u0026 \\\ngcloud config set account {{ACCOUNT}} \u0026\u0026 \\\ngcloud config set project ggn-nmfs-aa-dev-1\n```\n\n**Note:** Replace `{{ACCOUNT}}` with your NOAA Google account email.\n\n![Terminal Authentication](assets/instruction_3.png)\n\n---\n\n### 6. Reactivate the Environment Later\n\nYou can return to the AA-SI environment at any time by running:\n\n```bash\nsource aa_si/bin/activate\n```\n\n### 7. Python Virtual Environments\n\nThe startup script automatically creates a Python 3.10 virtual environment named `aa_si`. However, you may want to create additional virtual environments for other Python versions or purposes.\n\nFor example, to create environments referencing the Python version, you can use commands like these:\n\n```bash\n# Create a Python 3.10 virtual environment named aa_si10\npython3.10 -m venv aa_si10\n\n# Create a Python 3.11 virtual environment named aa_si11\npython3.11 -m venv aa_si11\n\n# Create a Python 3.12 virtual environment named aa_si12\npython3.12 -m venv aa_si12\n```\n\nTo activate these environments:\n\n```bash\n# On Linux/macOS\nsource aa_si10/bin/activate\n```\n\nFeel free to use environment names and Python versions that fit your workflow. This allows you to work with multiple Python versions or separate dependencies as needed.\n\n### 8. Start GCP authentication\nFollow browser prompts to authenticate via your NOAA credentials. A Link will be provided in the terminal and it will carry you throiugh a process of google email based authentication. THis is where your Noaa email account will be required.\n\n---\n\n## ➍ Using the AA-SI Toolset\n\n### 1. View Available Tools\n\nList available AA-SI commands and modules with:\n\n```bash\naa-help\n```\n\n---\n\n### 2. Example Command: Download \u0026 Plot Raw File\n\n```bash\naa-raw --file_name \"2107RL_CW-D20210813-T220732.raw\" --file_type \"raw\" --ship_name \"Reuben_Lasker\" --survey_name \"RL2107\" --echosounder \"EK80\" --data_source \"NCEI\" | aa-plot\n```\n\n---\n\n## ➎ Disclaimer\n\nThis repository is a scientific product and is not official communication of the National Oceanic and Atmospheric Administration, or the United States Department of Commerce. All NOAA GitHub project code is provided on an ‘as is’ basis and the user assumes responsibility for its use. Any claims against the Department of Commerce or its bureaus stemming from the use of this GitHub project will be governed by all applicable Federal law. Reference to specific commercial products, processes, or services by service mark, trademark, manufacturer, or otherwise does not imply endorsement or favoring by the Department of Commerce. Use of DOC seals or logos shall not suggest endorsement by DOC or the U.S. Government.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnmfs-ost%2Faa-si_gpcsetup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnmfs-ost%2Faa-si_gpcsetup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnmfs-ost%2Faa-si_gpcsetup/lists"}