Manage Workspaces (Tutorial)
| Abbreviations Key | |
| AIFI | Allen Institute for Immunology |
| CertPro | Certificate of Reproducibility |
| GCP | Google Cloud Platform |
| HISE | Human Immune System Explorer |
| STRIDES | Science and Technology Infrastructure for Discovery, Experimentation, and Sustainability |
At a Glance
Any visitor who browses Data Apps in the Explore portal can delve into AIFI research, visualizations, or data sets. Visitors who want to re-execute portions of another scientist's certificate of reproducibility (CertPro), however, must either be HISE users or establish a workspace guest account.
Do I Need a Workspace?
To re-execute portions of a certificate—for example, to re-execute a Jupyter notebook in its original environment—you must open a workspace guest account or be invited to use an existing one (see Add a Workspace User). Only the user who sets up the Google Cloud Platform (GCP) billing relationship can create a workspace.
But don't worry—even if you're not a HISE user and don't have a workspace of your own, you can browse the contents of all posted Data Apps:
Explore visualizations
Trace research methodology from ingest to published result
See which research subjects, samples, and cohorts were used
See which automated or custom pipelines were used to process the data
- Download HISE data or Jupyter notebooks (Google authentication required)
What Is a Workspace?
A workspace is a separate, fully provisioned computational space in which the steps of a CertPro can be re-executed in an environment that mimics the original tool stack. The workspace is built on GCP. If you're a HISE user, you have an institutional account that manages GCP billing and payment for you. If you're not a HISE or STRIDES user (see the accompanying note), any storage or compute costs you incur are charged directly to your GCP account. To establish a workspace, you must have a GCP billing ID. Follow the instructions below to create one.
HISE Users Registered HISE users automatically receive workspaces for CertPro re-execution. To find yours, log in to HISE and navigate to COLLABORATION SPACE > Data Apps. NIH Strides Scientists enrolled in STRIDES can use their STRIDES billing ID. For details, see the |
Instructions
Step 1: Set up a GCP billing ID
1. To establish a Google identity, or use an institutional email account tied to a Google identity.
2. If you're not a member of a Google Cloud organization but instead manage your Google Cloud resources using projects, you don't need permission to set up a cloud billing account. To follow the linked instructions.
Step 2: Sign in with Google
1. Navigate to the Collaboration Space.
2. In the LATEST PUBLICATIONS section, click a publication tile.
3. In the top navigation menu, click Reproducibility.
4. In the upper-right corner, click Start Exploration.
5. In the Creating an Account dialog box, click Next.
6. Click Sign in with Google, and then enter your Gmail or other Google-associated email address.
7. Use the camera on your mobile device to scan the QR code, and then follow the on-screen instructions to sign in. (The instructions vary, depending on your preferred sign-in method, such as touch ID or passkey.)
8. On the sign-in confirmation screen, click Confirm.
9. On the Select Google Account screen, click Next.
Step 3: Agree to terms and authorize billing
1. On the Terms and Conditions screen, read the Fees and Payment notice.
2. Click the terms and conditions link, and read the Allen Institute Terms of Use.
3. Close the window to return to the previous screen, and select both checkboxes to indicate that you've read the terms and conditions and agree to the payment terms.
4. Click Next.
5. Find the Billing Permissions payment dialog box. To authorize HISE to view and associate your GCP billing ID with the selected Google identity, click AUTHORIZE HISE TO READ BILLING.
Step 4: Associate your GCP billing ID with HISE
1. On the Choose an account screen, select the same Google account you used in the previous steps.
2. If you receive an error message saying that "Google hasn't verified this app," continue by clicking Advanced > Go to allenimmunology.org (unsafe).
3. To grant allenimmunology.org additional access to your Google account, on the next screen, click Continue.
4. In the Billing Permissions dialog box, enter your 18-digit GCP billing ID.
5. Click Next.
6. On the Confirm Details screen, click Start Exploration.
7. Click Go to Exploration Space. All set!
View Your Workspace Account
Follow the instructions below to view your account in the Explore portal.
1. Navigate to the Collaboration Space.
2. In the top navigation bar, click PROFILE.
3. On the User Profile page, view your name, email address, and Guest tag.
Add a User to Your Workspace
To add a user to your payments profile, follow the linked instructions. Only business accounts can add users. Individuals must obtain their own GCP billing IDs. For details, see the preceding instructions.
Sign Out of Your Workspace Account
1. Follow the instructions in the preceding section: View Your Workspace Account.
2. In the upper-right corner, click Sign Out.
Related Resources
Get Started with Data Apps (Tutorial)