|
1 | 1 | # Changes to `ga4gh/schemas` `master` branch since version `v0.5.1` (Oct 2, 2014)
|
2 | 2 |
|
3 |
| -### Pervasive changes |
| 3 | +## Pervasive changes |
4 | 4 |
|
5 | 5 | Renamed all protocols and records to remove the "`GA`" prefix from
|
6 | 6 | their names. (Hence `GASearchVariantSetsRequest` is now
|
7 |
| -`SearchVariantSetsRequest`, etc.) The exception is `GAException`, |
8 |
| -which is unchanged. |
| 7 | +`SearchVariantSetsRequest`, etc.) |
| 8 | +The exception is `GAException`, which is unchanged. |
9 | 9 |
|
10 | 10 | There is no longer one unitary namespace. Objects now reside in
|
11 | 11 | "`org.ga4gh.models`", methods in "`org.ga4gh.methods`".
|
12 | 12 |
|
13 |
| -Updated the version number to `0.6.0-SNAPSHOT`. |
| 13 | +Updated the version number to `0.6.0a1`. |
14 | 14 |
|
15 |
| -### Added |
16 | 15 |
|
17 |
| -Datasets are now used throughout the API. |
| 16 | +## Changes visible to API clients |
18 | 17 |
|
19 |
| -#### Methods: |
| 18 | +### Additions |
20 | 19 |
|
21 |
| -* `getDataset` |
22 |
| -* `searchDatasets` |
23 |
| -* `getReadGroupSet` |
24 |
| -* `getReadGroup` |
25 |
| -* `getVariant` |
26 |
| -* `getVariantSet` |
27 |
| -* `getCallSet` |
| 20 | +`Dataset` is now utilized throughout the API. |
28 | 21 |
|
29 |
| -#### Records: |
| 22 | +#### New methods, HTTP endpoints: |
30 | 23 |
|
31 |
| -* `ExternalIdentifier` |
32 |
| -* `Experiment` |
33 |
| -* `Dataset` |
34 |
| -* `ReadStats` |
35 |
| -* `Fragment` _(apparently unused)_ |
| 24 | +* `getDataset` via GET `datasets/<id>` |
| 25 | +* `searchDatasets` via POST `/datasets/search` |
| 26 | +* `getReadGroupSet` via GET `/readgroupsets/<id>` |
| 27 | +* `getReadGroup` via GET `/readgroups/<id>` |
| 28 | +* `getVariant` via GET `/variants/<id>` |
| 29 | +* `getVariantSet` via GET `/variantsets/<id>` |
| 30 | +* `getCallSet` via GET `/callsets/<id>` |
36 | 31 |
|
37 |
| -#### Enum: |
| 32 | +#### New and modified entities: |
38 | 33 |
|
39 |
| -* `Strand` |
40 |
| - |
41 |
| -### Removed |
42 |
| - |
43 |
| -* `src/main/resources/avro/beacon.avdl` |
44 |
| -* Files designated "Work In Progress" ("`wip`"): |
45 |
| - * `src/main/resources/avro/wip/metadata.avdl` |
46 |
| - * `src/main/resources/avro/wip/metadatamethods.avdl` |
47 |
| - * `src/main/resources/avro/wip/variationReference.avdl` |
48 |
| - |
49 |
| -### Changed |
50 |
| - |
51 |
| -Moved `GAException` to `methods.avdl`. |
| 34 | +* New record type `ExternalIdentifier` introduced. |
| 35 | +* New record type `ReadStats` now optionally part of a returned `ReadGroup` or `ReadGroupSet` object. |
| 36 | +* `Position` record type now specifies strand via new enum `Strand` (in place of `boolean reverseStrand`). |
52 | 37 |
|
53 | 38 | #### Field default values:
|
54 | 39 |
|
55 |
| -* `SearchReadsRequest.start` is optional and no longer defaults to 0. |
56 |
| -* Boolean fields in `ReadAlignment` now default to `null` instead of `false`. |
| 40 | +* `SearchReadsRequest.start` as passed into `/reads/search` is optional and no longer defaults to 0. |
| 41 | +* Boolean fields in `ReadAlignment` as returned from `/reads/search` now default to `null` instead of `false`. |
57 | 42 |
|
58 | 43 | #### Field types:
|
59 | 44 |
|
60 |
| -* `SearchVariantSetsRequest` now takes a single dataset ID, not an array. |
61 |
| -* `SearchCallSetsRequest` now takes a single variant set ID, not an array. |
62 |
| -* `SearchReferenceSetsRequest` changed two parameters from arrays to |
| 45 | +* `SearchVariantSetsRequest` as passed into `/variantsets/search` now takes a single dataset ID, not an array. |
| 46 | +* `SearchCallSetsRequest` as passed into `/callsets/search` now takes a single variant set ID, not an array. |
| 47 | +* `SearchReferenceSetsRequest` as passed into `/referencesets/search` changed two parameters from arrays to |
63 | 48 | singletons:
|
64 | 49 |
|
65 | 50 | * `md5checksum`
|
66 | 51 | * `accession`
|
67 | 52 |
|
68 | 53 | #### New fields:
|
69 | 54 |
|
70 |
| -* `SearchReferencesRequest` now accepts a `referenceSetId` parameter. |
71 |
| -* `SearchVariantsRequest` now takes a `variantSetId` parameter. |
72 |
| -* `SearchReadsRequest` now includes `readGroupIds`. |
73 |
| -* `SearchReadGroupSetsRequest` takes a `datasetId`. |
74 |
| -* `ReferenceSet` now includes a name. |
75 |
| -* `VariantSet` adds name and reference set ID fields. |
76 |
| -* `ReadGroup` adds `stats`. |
| 55 | +* `SearchReferencesRequest` passed into `/references/search` now accepts a `referenceSetId` parameter. |
| 56 | +* `SearchVariantsRequest` passed into `/variants/search` now takes a `variantSetId` parameter. |
| 57 | +* `SearchReadsRequest` passed into `/reads/search` now includes `readGroupIds`. |
| 58 | +* `SearchReadGroupSetsRequest` passed into `/readgroupsets/search` takes a `datasetId`. |
| 59 | +* `ReferenceSet` returned from `/references/search` now includes a name. |
| 60 | +* `VariantSet` returned from `/variants/search` adds name and reference set ID fields. |
| 61 | +* `ReadGroup` returned from `/readgroups/<id>` adds `stats`. |
| 62 | + |
| 63 | + |
| 64 | +## Changes internal to Schemas, documentation and organization |
| 65 | + |
| 66 | +### Removed |
| 67 | + |
| 68 | +* `src/main/resources/avro/beacon.avdl` |
| 69 | +* Files designated "Work In Progress" ("`wip`"): |
| 70 | + * `src/main/resources/avro/wip/metadata.avdl` |
| 71 | + * `src/main/resources/avro/wip/metadatamethods.avdl` |
| 72 | + * `src/main/resources/avro/wip/variationReference.avdl` |
| 73 | + |
| 74 | +### Changed |
| 75 | + |
| 76 | +Moved `GAException` to `methods.avdl`. |
77 | 77 |
|
78 | 78 | ## Documentation
|
79 | 79 |
|
|
0 commit comments