Api-roll 22: 2015-08-17

generated/googleapis_beta/lib/genomics/v1beta2.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis_beta.genomics.v1beta2;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
@@ skipping 1492 matching lines @@
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => null);
   }
 
   /**
    * Exports read group sets to a BAM file in Google Cloud Storage.
    *
    * Note that currently there may be some differences between exported BAM
-   * files and the original BAM file at the time of import. In particular,
-   * comments in the input file header will not be preserved, some custom tags
-   * will be converted to strings, and original reference sequence order is not
-   * necessarily preserved.
+   * files and the original BAM file at the time of import. See
+   * ImportReadGroupSets for details.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * Completes with a [ExportReadGroupSetsResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 58 matching lines @@
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ReadGroupSet.fromJson(data));
   }
 
   /**
    * Creates read group sets by asynchronously importing the provided
-   * information.
+   * information. The caller must have WRITE permissions to the dataset.
    *
-   * Note that currently comments in the input file header are not imported and
-   * some custom tags will be converted to strings, rather than preserving tag
-   * types. The caller must have WRITE permissions to the dataset.
+   * Notes on BAM import:
+   * - Tags will be converted to strings - tag types are not preserved
+   * - Comments (@CO) in the input file header are not imported
+   * - Original order of reference headers is not preserved
+   * - Any reverse stranded unmapped reads will be reverse complemented, and
+   * their qualities (and "BQ" tag, if any) will be reversed
+   * - Unmapped reads will be stripped of positional information (referenceName
+   * and position)
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * Completes with a [ImportReadGroupSetsResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 792 matching lines @@
 
 class VariantsetsResourceApi {
   final commons.ApiRequester _requester;
 
   VariantsetsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Creates a new variant set (only necessary in v1).
    *
+   * The provided variant set must have a valid datasetId set - all other fields
+   * are optional. Note that the id field will be ignored, as this is assigned
+   * by the server.
+   *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * Completes with a [VariantSet].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
@@ skipping 4848 matching lines @@
     }
     if (metadata != null) {
       _json["metadata"] = metadata.map((value) => (value).toJson()).toList();
     }
     if (referenceBounds != null) {
       _json["referenceBounds"] = referenceBounds.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }