Merge branch 'release/1.13.0'

ctsit · Jun 11, 2024 · d848165 · d848165
2 parents cdb1934 + e86aa7e
commit d848165
Show file tree

Hide file tree

Showing 12 changed files with 6,871 additions and 363 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,7 +1,7 @@
-# Change Log
-All notable changes to the Imagemap module will be documented in this file.
-This project adheres to [Semantic Versioning](http://semver.org/).
-
+# imagemap 1.13.0 (released 2024-06-11)
+- Add Grids Body Map (@schatto1, @saipavan10-git, @pbchase, #76, #77)
+- Rename instrument example files (@pbchase, #77)
+- Remove Andy Martin from config.json (@ChemiKyle)
 
 ## [1.12.0] - 2024-02-20
 ### Added

diff --git a/README.md b/README.md
@@ -1597,6 +1597,18 @@ This is a body rendering developed at Stanford for a specific project -- no attr
 Image provided by Yunfeng Dai.
 ![LADDER](./img/ladder_image.png)
 
+**`GRIDS_BODY_MAP_FRONT`**
+
+This is a map showing the anterior view of a human body, where the area inside the outline is split into 10 pixel by 10 pixel selectable grids. This allows for high fidelity selection of granular areas within the body. Use of "text box fields" within REDCap are encouraged for this map, due to the sheer number of "options".
+
+![GRIDS_BODY_MAP_FRONT](./img/antpainimage1000px.png)
+
+**`GRIDS_BODY_MAP_BACK`**
+
+This is a map showing the posterior view of a human body, where the area inside the outline is split into 10 pixel by 10 pixel selectable grids. This allows for high fidelity selection of granular areas within the body. Use of "text box fields" within REDCap are encouraged for this map, due to the sheer number of "options".
+
+![GRIDS_BODY_MAP_BACK](./img/postpainimage1000px.png)
+
 ## Usage
 To display one of the images above in a survey or data entry form, add a new field of type **Text Box** and include one of the following options in the **Action Tags / Field Annotation (optional)** field:
 
@@ -1623,14 +1635,16 @@ To display one of the images above in a survey or data entry form, add a new fie
 @IMAGEMAP=SZMN_SIDE
 @IMAGEMAP=DERM_PHOTO_BODY
 @IMAGEMAP=LADDER
+@IMAGEMAP=GRIDS_BODY_MAP_FRONT
+@IMAGEMAP=GRIDS_BODY_MAP_BACK
 ```
 
 Each region of an image is associated with a key, for example, the "Ankle (front-left)" of the female body diagram is linked to the key "f34". To find a particular key for a body part, please refer to the HTML files (map files) located in the folder `maps`. After selecting multiple body parts, the field containing the action tag `@IMAGEMAP` will have as a value a string of comma-separated keys, e.g. "f36,f17,f18,f21". Similarly, if using the faces diagram, the field containing the action tag (e.g. `@IMAGEMAP=SMILE_SCALE`) will have the value corresponding to the face clicked.
 
 
 ## Testing instrument
 
-This project includes an [Example Instrument](docs/Instrument\ Example.zip) that includes each of these image maps. It demonstrates different methods of using these image maps; which is suitable for testing or demonstration purposes.
+This project includes an [Example Instrument](docs/all_maps_Instrument_Example.zip) that includes each of these image maps. It demonstrates different methods of using these image maps; which is suitable for testing or demonstration purposes. Some image maps are also available in their own `*_Instrument_Example.zip` in the [docs](docs/) folder.
 
 
 ## Acknowledgements & Copyright
@@ -1652,4 +1666,5 @@ This project includes an [Example Instrument](docs/Instrument\ Example.zip) that
  * The 66 Swollen / 68 Tender Joint Map was contributed by Dr Tom Lynch from the Institute of Bone and Joint Research, University of Sydney. The image was adopted with permission from Dr Alexis Ogdie-Beatty and first published in this article from the OMERACT group: [website](http://www.jrheum.org/content/early/2019/05/24/jrheum.181089).
  * The FR_REGION was contributed by Hugo Potier of University Hospital of Nîmes. The image source come from [data.gouv.fr](http://data.gouv.fr).
  * Fibromyalgia self-report image appears in the article ["Fibromyalgia: A Clinical Review"](https://jamanetwork.com/journals/jama/fullarticle/1860480) by Daniel J. Clauw and is provided by Thomas Van Doorn and Dr. Andrea Nicol. Copyright 2014 American Medical Association. All rights reserved.
+ * The Grids Body Map (both front and back) were developed and contributed by Sumon Chattopadhyay and the BMIC team at the University of Utah.
 
diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-1.12.0
+1.13.0
diff --git a/config.json b/config.json
diff --git a/docs/Instrument Example.zip b/docs/Instrument Example.zip
diff --git a/docs/all_maps_Instrument_Example.zip b/docs/all_maps_Instrument_Example.zip
diff --git a/docs/example_project.xml b/docs/example_project.xml
diff --git a/docs/grids_body_maps_Instrument_Example.zip b/docs/grids_body_maps_Instrument_Example.zip
diff --git a/img/antpainimage1000px.png b/img/antpainimage1000px.png
diff --git a/img/postpainimage1000px.png b/img/postpainimage1000px.png
diff --git a/maps/grids_body_map_back.html b/maps/grids_body_map_back.html
diff --git a/maps/grids_body_map_front.html b/maps/grids_body_map_front.html