Add search_series and search_study

[yujanshrestha]

In an identical api tosearch_patients, provide APIs for Study and Series level queries.

 def search_series(self, search_query, additional_tags=None):
    pass

 def search_study(self, search_query, additional_tags=None):
    pass

At each level, also return the additional query / retrieve attributes as found here. http://dicom.nema.org/medical/dicom/2017c/output/chtml/part04/sect_C.3.4.html

For example, for the search_study query return the Number of Study Related Series and for the search_series return the Number of Series Related Instances

[yujanshrestha]

@dillonwilliams these APIs will be needed by the autoregister project.

[yujanshrestha]

@orwonthe FYI this ticket is for autoregister.

[dillonwilliams]

What fields would the search_query apply to? For example, the patient search queries on PatientID and PatientName.

[yujanshrestha]

I see. My intention was to just pass in the search dataset directly. I think this will actually be trivial. In the case of pynetdicom:

 def search_series(self, query_dataset, additional_tags=None):
    query_dataset.QueryRetrieveLevel = 'SERIES'
    return assoc.send_c_find(query_dataset, query_model='S')

 def search_study(self, query_dataset, additional_tags=None):
    query_dataset.QueryRetrieveLevel = 'STUDY'
    return assoc.send_c_find(query_dataset, query_model='S')

[johndgiese]

@yujanshrestha in this example code, where do we use additional_tags?

[yujanshrestha]

We can probably remove it entirely. I think the convention is add the attributes into query_dataset but with empty values.

The implementation for this should be trivial, writing tests for it may be a bit more involved.

[dillonwilliams]

It looks like we can get rid of the NumberOfImagesInSeries private tag and try to get the NumberOfSeriesRelatedInstances tag from the PACS instead. If not in the PACS, it should count up the instances returned with an IMAGE query like it does for the private tag now and put that in NumberOfSeriesRelatedInstances instead.