Merge pull request #10 from CPBridge/doc_changes

Added section in user guide about load_json_dataset method

Author: MGH & BWH Center for Clinical Data Science

docs/usage.rst

@@ -469,6 +469,20 @@ When frames are retrieved in image format, they can be converted into a *NumPy*
 
 .. _cli:
 
+Loading JSON Data To ``pydicom``
+++++++++++++++++++++++++++++++++
+
+Load metadata from JSON format into a ``pydicom.dataset.Dataset`` object.
+A common use for this is translating metadata received from a ``RetrieveMetadata`` or a ``SearchFor``-style request:
+
+.. code-block:: python
+
+    from dicomweb_client.api import load_json_dataset
+
+    metadata = client.retrieve_study_metadata('1.2.826.0.1.3680043.8.1055.1.20111103111148288.98361414.79379639')
+    metadata_datasets = [load_json_dataset(ds) for ds in metadata]
+
+
 Command Line Interface (CLI)
 ----------------------------