{"_id":"5bb1eeb7f5d52a0003532f0d","project":"5b0e13ffc4664e0003c75a66","version":{"_id":"5b0e13ffc4664e0003c75a67","project":"5b0e13ffc4664e0003c75a66","__v":4,"createdAt":"2015-09-17T16:58:03.490Z","releaseDate":"2015-09-17T16:58:03.490Z","categories":["5b0e13ffc4664e0003c75a68","5b0e13ffc4664e0003c75a69","5b0e13ffc4664e0003c75a6a","5b0e13ffc4664e0003c75a6b","5b0e13ffc4664e0003c75a6c","5b0e13ffc4664e0003c75a6d","5b0e13ffc4664e0003c75a6e","5b0e13ffc4664e0003c75a6f","5b0e13ffc4664e0003c75a70","5b0e13ffc4664e0003c75a71","5b0e13ffc4664e0003c75a72","5b0e13ffc4664e0003c75a73","5b0e13ffc4664e0003c75a74","5b0e13ffc4664e0003c75a75","5b0e13ffc4664e0003c75a76","5b0e13ffc4664e0003c75a77","5b0e13ffc4664e0003c75a89","5b0e13ffc4664e0003c75a8a","5b0e13ffc4664e0003c75a9d","5b0e13ffc4664e0003c75a9e","5b0e13ffc4664e0003c75a9f","5b0e13ffc4664e0003c75aa0","5b0e13ffc4664e0003c75aa1","5b0e13ffc4664e0003c75aa2","5b0e13ffc4664e0003c75aa3","5b0e13ffc4664e0003c75aa4","5b0e13ffc4664e0003c75aa5","5b0e13ffc4664e0003c75aa6","5b0e13ffc4664e0003c75aa7","5b0e13ffc4664e0003c75aa8","5b0e13ffc4664e0003c75aa9","5b0e13ffc4664e0003c75aaa","5b0e13ffc4664e0003c75aab","5b0e13ffc4664e0003c75aac","5b0e13ffc4664e0003c75aad","5b0e13ffc4664e0003c75aae","5b0e13ffc4664e0003c75aaf","5b0e13ffc4664e0003c75ab2","5bb3374f4306ad0003eb18e7","5bbf3c5373e72a000318362b","5bc065567d1cb0000384c649","5cbf19a5f9181f0033fbb968"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"5b0e13ffc4664e0003c75a70","project":"5b0e13ffc4664e0003c75a66","__v":0,"version":"5b0e13ffc4664e0003c75a67","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-09-17T17:33:29.016Z","from_sync":false,"order":23,"slug":"run-an-analysis","title":"RUN AN ANALYSIS"},"user":"566590c83889610d0008a253","__v":0,"parentDoc":null,"metadata":{"title":"","description":"","image":[]},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-10-01T09:53:59.628Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":6,"body":"## Overview\n\nConstant decrease in sequencing costs has resulted in exponential increase in amount of data being generated by the NGS technology. Due to its high volume, this data is usually stored in the cloud, which makes downloading/moving those files an extremely expensive operation.\n\nIn order to optimize task execution on Platform and its costs, it is important to understand the basics about locations where your files are stored and where the execution takes place.\n\nDataSTAGE powered by Seven Bridges currently works with two cloud providers, Amazon Web Services (AWS) and Google Cloud Platform (GCP), both of which are available for **file storage** and **computation** purposes. Each of the cloud infrastructure providers has cloud resources hosted in multiple locations across the world, called **regions**.\n\nIf you store your files on AWS and GCP US regions, the Platform offers managing all your work from a single space and spinning up chosen computation resources where your data lives, thus providing much easier cost optimization of your work.\n\nIn order to use files as inputs for a task on F4C, the files need to be uploaded/imported to the Platform, accessed from a mounted Amazon Simple Storage Service (S3) or Google Cloud Storage (GCS) bucket, or used from publicly available files (Seven Bridges Public Reference Files and available public datasets).\n\nThe files and the computation instances that are used to process the files may  be located in the same cloud provider's region, but can also be in different regions or even on different cloud providers. If the two locations are in the same region within one cloud provider's infrastructure, there will be no additional **data transfer costs** as the Platform can use the files directly from the location where they are stored.\n\nHowever, if these locations are in different regions or belong to different cloud providers, there will be additional data transfer costs as the Platform will need to transfer the files from the location where they are stored, to the location where computation is done. This data transfer is **charged by the cloud infrastructure provider** and passed through by Seven Bridges with no extra charge or fee.\n\nSeven Bridges provides full transparency of data transfer costs charged by cloud infrastructure providers and allows you to optimize them by defining your project location as described below. For a complete list of data transfer prices, please refer to [Amazon S3 Data Transfer Pricing ](https://aws.amazon.com/s3/pricing/#Data_Transfer_Pricing) and [Google Cloud Storage Network Pricing](https://cloud.google.com/storage/pricing#network-pricing).\n\n## Project locations\n\nWhen creating a project, you need to define the location (cloud provider and region) where the tasks in the project will be executed. The available options are:\n\n* **aws:us-east-1** - AWS US East (N.Virginia)\n* **google:us-west1** - GCP US West (Oregon)\n\nThe selected location is the location for analysis (task or Data Cruncher) execution, e.g. the exact region where computation resources (virtual instances and accompanying attached disks) will be spun up.\n\nAlso, all file uploads will end up at this location (analysis outputs, user uploads and imports). This option is used to help you organize your workspace in the most cost-optimal way, leaving you the control over execution and file organization.\n\n## File locations\n\nIn order to use files as inputs for a task on the Platform, the files need to be:\n\n* **Uploaded/imported toF4C**. When uploading files to a project, they will be uploaded to the location (cloud provider and region) selected as the project location on project creation. This allows for cost optimization as all analyses (tasks and Data Cruncher) will be executed on computation instances at the same location, thus causing no additional data transfer costs.\n* **Accessed from a mounted Amazon Simple Storage Service (S3) or Google Cloud Storage (GCS) bucket**. The Platform allows you to mount your own external bucket where you store the files that you want to use as inputs for an analysis. In this case, there will be additional data transfer costs if your files are hosted at a different location from the one defined for your project. See below for details.\n* **Used from publicly available files (Seven Bridges Public Reference Files and available public datasets)**. Files that are available through the Public Reference Files repository and public datasets on the Platform are hosted in all available project locations and will never cause additional data transfer costs, regardless of your project's location. \n* **Generated as outputs from a previously completed task within the same project.** Task outputs are stored at the defined project location and will not cause any additional data transfer costs when used as inputs in a different task within the same project.\n\n## File transfer costs\n\nAdditional file transfer costs charged by the cloud infrastructure provider can happen in the situations described below.\n\n### Using files copied between projects that are in different locations\n\nWhen you copy a file between projects that are in different locations, the file will not be physically copied to the target project's location. Instead, it will be used from the location where it was originally uploaded to, as shown in the diagram below:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/e23ccc4-copy-file-diagram.png\",\n        \"copy-file-diagram.png\",\n        475,\n        182,\n        \"#e1bec0\"\n      ]\n    }\n  ]\n}\n[/block]\nWhen you set such a file as an input in your task, a warning will be displayed below the input saying that the location of the file is different from the project location. Please be aware that this will cause additional costs as the file will need to leave the region or cloud provider where it is stored, to be brought to the computation instance where it will be processed.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/75fd0e9-project-and-file-locations-1.png\",\n        \"project-and-file-locations-1.png\",\n        616,\n        681,\n        \"#f0eee5\"\n      ]\n    }\n  ]\n}\n[/block]\nWhen a task containing such files is completed, the cost of data transfer is included in the total costs of task execution and will be charged together with the task price. Data transfer cost will be shown as a separate item in the task price tooltip on the task page.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/69f8f0b-project-and-file-locations-2.png\",\n        \"project-and-file-locations-2.png\",\n        825,\n        278,\n        \"#f0f0f1\"\n      ]\n    }\n  ]\n}\n[/block]\nSeven Bridges provides full transparency of data transfer costs charged by cloud infrastructure providers and passes them through with no extra charge or fee. For a complete list of data transfer prices, please refer to [Amazon S3 Data Transfer Pricing](https://aws.amazon.com/s3/pricing/#Data_Transfer_Pricing) and [Google Cloud Storage Network Pricing](https://cloud.google.com/storage/pricing#network-pricing).\n\n### Using files from mounted AWS S3 or GCS buckets\n\nAnother option that might cause data transfer costs is the use of files from mounted cloud storage buckets. If your bucket is in a location that is different from the location of the project in which you want to use the files, when executing an analysis within the project, the files will need to be transferred to the project's location as this is where the computation will take place.\n\nIn this case, there will be additional file transfer costs charged directly to your account with the cloud storage provider. Also, when using such files as inputs for a task, the Platform will not display a warning about the location of the input file being different from the project location.\n\nTo optimize your task execution costs, when creating a project and planning the analyses that will be executed within that project, please keep in mind where your input files are stored and choose a project location that matches the location of your files, if possible.\n\nAlso, please keep in mind that the location of a project cannot be changed once the project has been created.\n\nWhen exporting a file from DataSTAGE powered by Seven Bridges to an attached volume, export is possible only to a volume that is in the same location (cloud provider and region) as the location of your project. Therefore, exporting to a volume will not cause any additional file transfer costs, as the transfer will take place within the same location.","excerpt":"","slug":"project-and-file-locations","type":"basic","title":"Project and file locations"}

Project and file locations


## Overview Constant decrease in sequencing costs has resulted in exponential increase in amount of data being generated by the NGS technology. Due to its high volume, this data is usually stored in the cloud, which makes downloading/moving those files an extremely expensive operation. In order to optimize task execution on Platform and its costs, it is important to understand the basics about locations where your files are stored and where the execution takes place. DataSTAGE powered by Seven Bridges currently works with two cloud providers, Amazon Web Services (AWS) and Google Cloud Platform (GCP), both of which are available for **file storage** and **computation** purposes. Each of the cloud infrastructure providers has cloud resources hosted in multiple locations across the world, called **regions**. If you store your files on AWS and GCP US regions, the Platform offers managing all your work from a single space and spinning up chosen computation resources where your data lives, thus providing much easier cost optimization of your work. In order to use files as inputs for a task on F4C, the files need to be uploaded/imported to the Platform, accessed from a mounted Amazon Simple Storage Service (S3) or Google Cloud Storage (GCS) bucket, or used from publicly available files (Seven Bridges Public Reference Files and available public datasets). The files and the computation instances that are used to process the files may be located in the same cloud provider's region, but can also be in different regions or even on different cloud providers. If the two locations are in the same region within one cloud provider's infrastructure, there will be no additional **data transfer costs** as the Platform can use the files directly from the location where they are stored. However, if these locations are in different regions or belong to different cloud providers, there will be additional data transfer costs as the Platform will need to transfer the files from the location where they are stored, to the location where computation is done. This data transfer is **charged by the cloud infrastructure provider** and passed through by Seven Bridges with no extra charge or fee. Seven Bridges provides full transparency of data transfer costs charged by cloud infrastructure providers and allows you to optimize them by defining your project location as described below. For a complete list of data transfer prices, please refer to [Amazon S3 Data Transfer Pricing ](https://aws.amazon.com/s3/pricing/#Data_Transfer_Pricing) and [Google Cloud Storage Network Pricing](https://cloud.google.com/storage/pricing#network-pricing). ## Project locations When creating a project, you need to define the location (cloud provider and region) where the tasks in the project will be executed. The available options are: * **aws:us-east-1** - AWS US East (N.Virginia) * **google:us-west1** - GCP US West (Oregon) The selected location is the location for analysis (task or Data Cruncher) execution, e.g. the exact region where computation resources (virtual instances and accompanying attached disks) will be spun up. Also, all file uploads will end up at this location (analysis outputs, user uploads and imports). This option is used to help you organize your workspace in the most cost-optimal way, leaving you the control over execution and file organization. ## File locations In order to use files as inputs for a task on the Platform, the files need to be: * **Uploaded/imported toF4C**. When uploading files to a project, they will be uploaded to the location (cloud provider and region) selected as the project location on project creation. This allows for cost optimization as all analyses (tasks and Data Cruncher) will be executed on computation instances at the same location, thus causing no additional data transfer costs. * **Accessed from a mounted Amazon Simple Storage Service (S3) or Google Cloud Storage (GCS) bucket**. The Platform allows you to mount your own external bucket where you store the files that you want to use as inputs for an analysis. In this case, there will be additional data transfer costs if your files are hosted at a different location from the one defined for your project. See below for details. * **Used from publicly available files (Seven Bridges Public Reference Files and available public datasets)**. Files that are available through the Public Reference Files repository and public datasets on the Platform are hosted in all available project locations and will never cause additional data transfer costs, regardless of your project's location. * **Generated as outputs from a previously completed task within the same project.** Task outputs are stored at the defined project location and will not cause any additional data transfer costs when used as inputs in a different task within the same project. ## File transfer costs Additional file transfer costs charged by the cloud infrastructure provider can happen in the situations described below. ### Using files copied between projects that are in different locations When you copy a file between projects that are in different locations, the file will not be physically copied to the target project's location. Instead, it will be used from the location where it was originally uploaded to, as shown in the diagram below: [block:image] { "images": [ { "image": [ "https://files.readme.io/e23ccc4-copy-file-diagram.png", "copy-file-diagram.png", 475, 182, "#e1bec0" ] } ] } [/block] When you set such a file as an input in your task, a warning will be displayed below the input saying that the location of the file is different from the project location. Please be aware that this will cause additional costs as the file will need to leave the region or cloud provider where it is stored, to be brought to the computation instance where it will be processed. [block:image] { "images": [ { "image": [ "https://files.readme.io/75fd0e9-project-and-file-locations-1.png", "project-and-file-locations-1.png", 616, 681, "#f0eee5" ] } ] } [/block] When a task containing such files is completed, the cost of data transfer is included in the total costs of task execution and will be charged together with the task price. Data transfer cost will be shown as a separate item in the task price tooltip on the task page. [block:image] { "images": [ { "image": [ "https://files.readme.io/69f8f0b-project-and-file-locations-2.png", "project-and-file-locations-2.png", 825, 278, "#f0f0f1" ] } ] } [/block] Seven Bridges provides full transparency of data transfer costs charged by cloud infrastructure providers and passes them through with no extra charge or fee. For a complete list of data transfer prices, please refer to [Amazon S3 Data Transfer Pricing](https://aws.amazon.com/s3/pricing/#Data_Transfer_Pricing) and [Google Cloud Storage Network Pricing](https://cloud.google.com/storage/pricing#network-pricing). ### Using files from mounted AWS S3 or GCS buckets Another option that might cause data transfer costs is the use of files from mounted cloud storage buckets. If your bucket is in a location that is different from the location of the project in which you want to use the files, when executing an analysis within the project, the files will need to be transferred to the project's location as this is where the computation will take place. In this case, there will be additional file transfer costs charged directly to your account with the cloud storage provider. Also, when using such files as inputs for a task, the Platform will not display a warning about the location of the input file being different from the project location. To optimize your task execution costs, when creating a project and planning the analyses that will be executed within that project, please keep in mind where your input files are stored and choose a project location that matches the location of your files, if possible. Also, please keep in mind that the location of a project cannot be changed once the project has been created. When exporting a file from DataSTAGE powered by Seven Bridges to an attached volume, export is possible only to a volume that is in the same location (cloud provider and region) as the location of your project. Therefore, exporting to a volume will not cause any additional file transfer costs, as the transfer will take place within the same location.