Quick Start Guide: Difference between revisions

From BCOeditor Wiki
Jump to navigation Jump to search
Line 5: Line 5:
== How to get started ==
== How to get started ==


#[https://wiki.biocomputeobject.org/index.php?title=Account_registration Create an account] ‘ ’: Sign up for an account to access the platforms features using the 'Log in' button on the right hand corner of the screen. This will direct you to a sign in page where you can log in or sign up for a new account.[[File:Screenshot 2023-09-07 134629.jpg|center|thumb|396x396px]][[File:9.png|center|thumb|413x413px]]
#[https://wiki.biocomputeobject.org/index.php?title=Account_registration Create an account]: Sign up for an account to access the platforms features using the 'Log in' button on the right hand corner of the screen. This will direct you to a sign in page where you can log in or sign up for a new account.[[File:Screenshot 2023-09-07 134629.jpg|center|thumb|396x396px]][[File:9.png|center|thumb|413x413px]]
#Navigating the interface: When creating a BioCompute Object (BCO) there are various domains that will require attention as each of them serve as a specific purpose in documentation to maintain accuracy and comprehensiveness. To get started with the builder, please click on the drop down menu on the top right of the screen. There are eight top-level domains, only five of which are required: Provenance domain, Usability domain, Description domain, Execution domain, and Input and Output Domain. Please get acquainted with [https://wiki.biocomputeobject.org/index.php?title=Bco-domains the different domains] to understand what information is essential to the sections.[[File:Screenshot (396).png|center|thumb|1153x1153px]][[File:Screenshot 2023-09-18 124635.jpg|center|thumb|740x740px]]
#Navigating the interface: The navigation bar serves as a convenient hub for navigating the interface. Anytime you wish, simply click on the 'Home' button located at the top left corner of the screen to return to the main page. Additionally, the first icon on the top left, when clicked, reveals a dropdown menu containing icons that allow you to easily access the Builder, Prefix Registry, or BCODB (BCO Database).
# Accessing documentation: Visit our documentation at [[Search|https://wiki.biocomputeobject.org/index.php?title=Search]]. The platform offers convenient access to public BioCompute (BCOs) for searching and downloading, even without signing in. However, to create and modify BCOs, signing in is necessary. Valuable resources can be found throughout the WikiPage to help you navigate the platform effectively.
#*Home Button: Click the 'Home' button at the top left corner to return to the main page at any time.
#*First Icon (Top Left): Opens a dropdown menu with quick access to the Builder, Prefix Registry, or BCODB (BCO Database).[[File:(397)1.png|center|thumb|942x942px]]
#*Second Icon (Top Right): Reveals a dropdown menu with links to the Quick Start Guide, BioCompute API, Wiki, and BCO Resources.   /// The 2nd icon on the top right shows a dropdown menu that displays the links to the following: this Quick Start Guide, BioCompute API, Wiki, BCO Resources. [[File:(398).png|center|thumb|939x939px]]
#*Third Icon: Opens a dropdown menu for reporting issues or contacting support if you encounter any concerns. /// The 3rd icon shows a drop down menu to either Report and issue, or Contact Us, which will be useful whenever you may come across any issues or concerns on the platform. [[File:Screenshot (399).png|center|thumb|941x941px]]
#*Info Icon: Provides more information about BioCompute, including our mission, story, goals, and details about our team members and collaborators. /// The info icon shows more information on BioCompute including our mission, our story, our goals, and team members as well as collaborators.  [[File:Screenshot (400).png|center|thumb|875x875px]]
# [https://wiki.biocomputeobject.org/index.php?title=Search Accessing documentation]: The platform offers convenient access to public BioCompute (BCOs) for searching and downloading, even without signing in. However, to create and modify BCOs, signing in is necessary. Valuable resources can be found throughout the WikiPage to help you navigate the platform effectively.


== How to create a BCO ==
== How to create a BCO ==


# [https://wiki.biocomputeobject.org/index.php?title=Buildbcos Starting a New BCO]: To create a new BCO, click on the BCO tools icon shown in the top right corner. From the drop-down menu, select the ‘Builder’ icon. This will direct you to a page with the different domains on the left side of the screen.[[File:Screenshot (394).png|center|thumb|843x843px]]
# [https://wiki.biocomputeobject.org/index.php?title=Buildbcos Starting a New BCO]: To create a new BCO, click on the BCO tools icon shown in the top right corner. From the drop-down menu, select the ‘Builder’ icon. This will direct you to a page with the different domains on the left side of the screen.[[File:Screenshot (394).png|center|thumb|843x843px]]
# Defining workflows and Analysis: Defining the workflow and the parameters will be dependent on the analysis being conducted Pay close attention to the details of your analysis to ensure accuracy in parameters and other metadata fields, such as title, description, and author information. When collating the workflow and analysis, remember to include data sources and complete the domains to appropriately reflect your references and guides.
# Defining workflows and Analysis: Pay attention to the details of your analysis to ensure accuracy in parameters and other metadata fields, such as title, description, and author information. To get started with the builder, please click on the drop down menu on the top right of the screen. When creating a BioCompute Object (BCO) there are various domains that will require attention as each of them serve as a specific purpose in documentation to maintain accuracy and comprehensiveness. There are eight top-level domains, only five of which are required: Provenance domain, Usability domain, Description domain, Execution domain, and Input and Output Domain. Please get acquainted with the different domains [https://wiki.biocomputeobject.org/index.php?title=Bco-domains here] to understand what information is essential to the sections.[[File:Screenshot (396).png|center|thumb|1153x1153px]][[File:Screenshot 2023-09-18 124635.jpg|center|thumb|740x740px]]
 
# Saving and Publishing: Before publishing, review and save the BCO to ensure accuracy of the information that you have entered into your BCO and that your data is not lost. Once you are certain that your documentation is complete, you can proceed to publish the BCO, making it accessible to collaborators or the community if desired.
# Saving and Publishing: Before publishing, review and save the BCO to ensure accuracy of the information that you have entered into your BCO and that your data is not lost. Once you are certain that your documentation is complete, you can proceed to publish the BCO, making it accessible to collaborators or the community if desired.


== Where do I go to search for an existing BCO ==
== Where do I go to search for an existing BCO ==


# BioCompute Database Search: At the top of the page, you'll find a convenient search bar. It provides direct access to the BCO repository, where you can explore and search for existing BioCompute Objects (BCOs)[[File:Screenshot 2023-09-11 120504.jpg|center|thumb|823x823px]]
# [https://wiki.biocomputeobject.org/index.php?title=Search BioCompute Database Search]: At the top of the page, you'll find a convenient search bar. It provides direct access to the BCO repository, where you can explore and search for existing BioCompute Objects (BCOs)[[File:Screenshot 2023-09-11 120504.jpg|center|thumb|823x823px]]
#* Advanced Search: If you need more specific search results, we offer an advanced search option. You can filter your search by BCO IDs, names/titles, and prefixes. This feature allows for precise and efficient discovery of the BCOs you're looking for.[[File:Screenshot (390).png|center|thumb|827x827px]]
#* Advanced Search: If you need more specific search results, we offer an advanced search option. You can filter your search by BCO IDs, names/titles, and prefixes. This feature allows for precise and efficient discovery of the BCOs you're looking for.[[File:Screenshot (390).png|center|thumb|827x827px]]
# Prefix Registry: The Prefix Registry is a BioCompute feature that helps you organize and collaborate efficiently. It allows you to group related BioCompute Objects (BCOs) under specific prefixes. For example, … Instead of juggling multiple BCOs from different projects or areas, you can assign a unique prefix to each project or category. This makes it easy to distinguish and find BCOs when you search or collaborate. In a nutshell, the Prefix Registry streamlines organization and collaboration by providing clear labels for your BCOs, making your work more efficient.[[File:Screenshot (391)1.png|center|thumb|1114x1114px]]
# [https://wiki.biocomputeobject.org/index.php?title=Prefix_registration Prefix Registry]: The Prefix Registry is a BioCompute feature that helps you organize and collaborate efficiently. It allows you to group related BioCompute Objects (BCOs) under specific prefixes. Instead of juggling multiple BCOs from different projects or areas, you can assign a unique prefix to each project or category. This makes it easy to distinguish and find BCOs when you search or collaborate. In a nutshell, the Prefix Registry streamlines organization and collaboration by providing clear labels for your BCOs, making your work more efficient.[[File:Screenshot (391)1.png|center|thumb|1114x1114px]]
# Downloading and Viewing BCOs: On the builder page, you have the option to download BCOs directly to your local device as JSON files to be viewed offline at your convenience. If you have BCOs stored that you would like to bring to the BioCompute platform, you can easily upload them seamlessly from your device for further editing, sharing, or collaboration. This functionality enhances your workflow by providing flexibility and accessibility to your BCOs from anywhere, at any time.[[File:Screenshot (393).png|center|thumb|973x973px]]
# Downloading and Viewing BCOs: '''On the builder page''', you have the option to download BCOs directly to your local device as JSON files to be viewed offline at your convenience. If you have BCOs stored that you would like to bring to the BioCompute platform, you can easily upload them seamlessly from your device for further editing, sharing, or collaboration. This functionality enhances your workflow by providing flexibility and accessibility to your BCOs from anywhere, at any time.[[File:Screenshot (393).png|center|thumb|973x973px]]

Revision as of 19:12, 18 September 2023

BioCompute is a powerful tool used for workflow documentation of bioinformatics analyses which allows for transparency and reproducibility in bioinformatics research. A BioCompute Object (BCO) is a representation of your analyses to show the workflow created on this platform.

Now, let’s get started with BioCompute Objects! Please visit: https://biocomputeobject.org/

How to get started

  1. Create an account: Sign up for an account to access the platforms features using the 'Log in' button on the right hand corner of the screen. This will direct you to a sign in page where you can log in or sign up for a new account.
    Screenshot 2023-09-07 134629.jpg
    9.png
  2. Navigating the interface: The navigation bar serves as a convenient hub for navigating the interface. Anytime you wish, simply click on the 'Home' button located at the top left corner of the screen to return to the main page. Additionally, the first icon on the top left, when clicked, reveals a dropdown menu containing icons that allow you to easily access the Builder, Prefix Registry, or BCODB (BCO Database).
    • Home Button: Click the 'Home' button at the top left corner to return to the main page at any time.
    • First Icon (Top Left): Opens a dropdown menu with quick access to the Builder, Prefix Registry, or BCODB (BCO Database).
      (397)1.png
    • Second Icon (Top Right): Reveals a dropdown menu with links to the Quick Start Guide, BioCompute API, Wiki, and BCO Resources. /// The 2nd icon on the top right shows a dropdown menu that displays the links to the following: this Quick Start Guide, BioCompute API, Wiki, BCO Resources.
      (398).png
    • Third Icon: Opens a dropdown menu for reporting issues or contacting support if you encounter any concerns. /// The 3rd icon shows a drop down menu to either Report and issue, or Contact Us, which will be useful whenever you may come across any issues or concerns on the platform.
      Screenshot (399).png
    • Info Icon: Provides more information about BioCompute, including our mission, story, goals, and details about our team members and collaborators. /// The info icon shows more information on BioCompute including our mission, our story, our goals, and team members as well as collaborators.
      Screenshot (400).png
  3. Accessing documentation: The platform offers convenient access to public BioCompute (BCOs) for searching and downloading, even without signing in. However, to create and modify BCOs, signing in is necessary. Valuable resources can be found throughout the WikiPage to help you navigate the platform effectively.

How to create a BCO

  1. Starting a New BCO: To create a new BCO, click on the BCO tools icon shown in the top right corner. From the drop-down menu, select the ‘Builder’ icon. This will direct you to a page with the different domains on the left side of the screen.
    Screenshot (394).png
  2. Defining workflows and Analysis: Pay attention to the details of your analysis to ensure accuracy in parameters and other metadata fields, such as title, description, and author information. To get started with the builder, please click on the drop down menu on the top right of the screen. When creating a BioCompute Object (BCO) there are various domains that will require attention as each of them serve as a specific purpose in documentation to maintain accuracy and comprehensiveness. There are eight top-level domains, only five of which are required: Provenance domain, Usability domain, Description domain, Execution domain, and Input and Output Domain. Please get acquainted with the different domains here to understand what information is essential to the sections.
    Screenshot (396).png
    Screenshot 2023-09-18 124635.jpg
  3. Saving and Publishing: Before publishing, review and save the BCO to ensure accuracy of the information that you have entered into your BCO and that your data is not lost. Once you are certain that your documentation is complete, you can proceed to publish the BCO, making it accessible to collaborators or the community if desired.

Where do I go to search for an existing BCO

  1. BioCompute Database Search: At the top of the page, you'll find a convenient search bar. It provides direct access to the BCO repository, where you can explore and search for existing BioCompute Objects (BCOs)
    Screenshot 2023-09-11 120504.jpg
    • Advanced Search: If you need more specific search results, we offer an advanced search option. You can filter your search by BCO IDs, names/titles, and prefixes. This feature allows for precise and efficient discovery of the BCOs you're looking for.
      Screenshot (390).png
  2. Prefix Registry: The Prefix Registry is a BioCompute feature that helps you organize and collaborate efficiently. It allows you to group related BioCompute Objects (BCOs) under specific prefixes. Instead of juggling multiple BCOs from different projects or areas, you can assign a unique prefix to each project or category. This makes it easy to distinguish and find BCOs when you search or collaborate. In a nutshell, the Prefix Registry streamlines organization and collaboration by providing clear labels for your BCOs, making your work more efficient.
    Screenshot (391)1.png
  3. Downloading and Viewing BCOs: On the builder page, you have the option to download BCOs directly to your local device as JSON files to be viewed offline at your convenience. If you have BCOs stored that you would like to bring to the BioCompute platform, you can easily upload them seamlessly from your device for further editing, sharing, or collaboration. This functionality enhances your workflow by providing flexibility and accessibility to your BCOs from anywhere, at any time.
    Screenshot (393).png