simple-icd-10-cm 1.3.0__tar.gz → 1.4.0__tar.gz

{simple_icd_10_cm-1.3.0 → simple_icd_10_cm-1.4.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021-2025 Stefano Travasci
+Copyright (c) 2021-2026 Stefano Travasci
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{simple_icd_10_cm-1.3.0/simple_icd_10_cm.egg-info → simple_icd_10_cm-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simple_icd_10_cm
-Version: 1.3.0
+Version: 1.4.0
 Summary: A simple python library for ICD-10-CM codes
 Home-page: https://github.com/StefanoTrv/simple_icd_10_CM
 Author: Stefano Travasci
@@ -53,6 +53,8 @@ A simple python library for ICD-10-CM codes
   * [get_seven_chr_def(code, search_in_ancestors=False, prioritize_blocks=False)](#get_seven_chr_defcode-search_in_ancestorsfalse-prioritize_blocksfalse)
   * [get_use_additional_code(code, search_in_ancestors=False, prioritize_blocks=False)](#get_use_additional_codecode-search_in_ancestorsfalse-prioritize_blocksfalse)
   * [get_code_first(code, search_in_ancestors=False, prioritize_blocks=False)](#get_code_firstcode-search_in_ancestorsfalse-prioritize_blocksfalse)
+  * [get_code_also(code, search_in_ancestors=False, prioritize_blocks=False)](#get_code_alsocode-search_in_ancestorsfalse-prioritize_blocksfalse)
+  * [get_notes(code, search_in_ancestors=False, prioritize_blocks=False)](#get_notescode-search_in_ancestorsfalse-prioritize_blocksfalse)
   * [get_full_data(code, search_in_ancestors=False, prioritize_blocks=False)](#get_full_datacode-search_in_ancestorsfalse-prioritize_blocksfalse)
   * [get_parent(code, prioritize_blocks=False)](#get_parentcode-prioritize_blocksfalse)
   * [get_children(code, prioritize_blocks=False)](#get_childrencode-prioritize_blocksfalse)
@@ -70,6 +72,7 @@ A simple python library for ICD-10-CM codes
 * [Conclusion](#conclusion)
 
 ## Release notes
+* **1.4.0**: The data in the fields "codeAlso" and "notes" can now be retrieved using the get_code_also() and get_notes() functions
 * **1.3.0**:
   * Users can now use their preferred ICD-10-CM release by providing properly formatted files as inputs
   * The default ICD-10-CM release of the library is now the **April 2025 release**
@@ -89,7 +92,7 @@ The objective of this library is to provide a simple instrument for dealing with
 If you are looking for a library that deals with ICD-10 codes instead of ICD-10-CM codes, you can check the [simple_icd_10 library](https://github.com/StefanoTrv/simple_icd_10), which is based on the 2019 version of ICD-10. If you are interested in the ICD-11 MMS classification, you can check out instead the [simple_icd_11 library](https://github.com/StefanoTrv/simple_icd_11).  
 There is also a Java version of this library, [SimpleICD10CM-Java-edition](https://github.com/StefanoTrv/SimpleICD10CM-Java-edition).
 
-The data used in this library was taken from the [website of the CDC]((https://www.cdc.gov/nchs/icd/icd-10-cm/files.html). This library currently uses the **April 2025 release of ICD-10-CM**. This package can be configured to use other releases of the ICD-10-CM classification, read the section [Using other ICD-10-CM releases](#using-other-icd-10-cm-releases) for more details.
+The data used in this library was taken from the [website of the CDC](https://www.cdc.gov/nchs/icd/icd-10-cm/files.html). This library currently uses the **April 2025 release of ICD-10-CM**. This package can be configured to use other releases of the ICD-10-CM classification, read the section [Using other ICD-10-CM releases](#using-other-icd-10-cm-releases) for more details.
 
 If you feel like supporting me, please check out the [Conclusion section](#conclusion).
 
@@ -347,6 +350,30 @@ cm.get_code_first("S04.01")
 cm.get_code_first("S04.01",search_in_ancestors=True)
 #'any associated intracranial injury (S06.-)'
 ```
+### get_code_also(code, search_in_ancestors=False, prioritize_blocks=False)
+This function takes a string as input. If the string is a valid ICD-10-CM code, it returns a **string** containing the data of the "codeAlso" field of this code, otherwise it raises a ValueError. If this code does not have a "codeAlso" field, it returns an empty string. Please see [Instructional Notations](https://github.com/StefanoTrv/simple_icd_10_CM/blob/master/Instructional%20Notations.md) if you have doubts about the meaning of this field. When the optional argument `search_in_ancestors` is set to True, if the given code doesn't have a "codeAlso" field but one of its ancestor does, the "codeAlso" data of the closer ancestor that contains such a field is returned. For the meaning of the optional argument `prioritize_blocks`, please see [Blocks containing only one category](#blocks-containing-only-one-category).
+```python
+cm.get_code_also("I82.41")
+#''
+cm.get_code_also("Z23")
+#', if applicable, encounter for immunization safety counseling (Z71.85)'
+cm.get_code_also("Z49.0")
+#''
+cm.get_code_also("Z49.0",search_in_ancestors=True)
+#'associated end stage renal disease (N18.6)'
+```
+### get_notes(code, search_in_ancestors=False, prioritize_blocks=False)
+This function takes a string as input. If the string is a valid ICD-10-CM code, it returns a **string** containing the data of the "notes" field of this code, otherwise it raises a ValueError. If this code does not have a "notes" field, it returns an empty string. When the optional argument `search_in_ancestors` is set to True, if the given code doesn't have a "notes" field but one of its ancestor does, the "notes" data of the closer ancestor that contains such a field is returned. For the meaning of the optional argument `prioritize_blocks`, please see [Blocks containing only one category](#blocks-containing-only-one-category).
+```python
+cm.get_notes("I82.41")
+#''
+cm.get_notes("Z23")
+#'procedure codes are required to identify the types of immunizations given'
+cm.get_notes("C91.00")
+#''
+cm.get_notes("C91.00",search_in_ancestors=True)
+#'Codes in subcategory C91.0- should only be used for T-cell and B-cell precursor leukemia'
+```
 ### get_full_data(code, search_in_ancestors=False, prioritize_blocks=False)
 This function takes a string as input. If the string is a valid ICD-10-CM code, it returns a string containing all the available data of the code, otherwise it raises a ValueError. The empty fields are omitted from the string, except for the list of children (see second example below). When the optional argument `search_in_ancestors` is set to True, if the given code doesn't have a certain field but one of its ancestor does, the data of the closer ancestor that contains such a field is returned: see the previous functions to know which are the fields that are influenced by this argument and which are not. For the meaning of the optional argument `prioritize_blocks`, please see [Blocks containing only one category](#blocks-containing-only-one-category).
 ```python
@@ -489,7 +516,8 @@ If you find this library useful and are feeling generous, consider making a dona
 
 ---
 
-Paypal: [![Donate](https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif)](https://www.paypal.com/donate?hosted_button_id=9HMMFAZE248VN)
+[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/J3J81G2OSG)  
+[![Paypal](https://pics.paypal.com/00/s/NDU5Y2RmMjQtMTVmYi00MDIyLTgyMzMtMTFiNDY1MjUzMDA5/file.PNG)](https://www.paypal.com/donate?hosted_button_id=9HMMFAZE248VN)
 
 Curecoin: BKxCWuWzsqtLzAvAjtpsHpJ7LqFHPubqft
 

{simple_icd_10_cm-1.3.0 → simple_icd_10_cm-1.4.0}/README.md

@@ -28,6 +28,8 @@ A simple python library for ICD-10-CM codes
   * [get_seven_chr_def(code, search_in_ancestors=False, prioritize_blocks=False)](#get_seven_chr_defcode-search_in_ancestorsfalse-prioritize_blocksfalse)
   * [get_use_additional_code(code, search_in_ancestors=False, prioritize_blocks=False)](#get_use_additional_codecode-search_in_ancestorsfalse-prioritize_blocksfalse)
   * [get_code_first(code, search_in_ancestors=False, prioritize_blocks=False)](#get_code_firstcode-search_in_ancestorsfalse-prioritize_blocksfalse)
+  * [get_code_also(code, search_in_ancestors=False, prioritize_blocks=False)](#get_code_alsocode-search_in_ancestorsfalse-prioritize_blocksfalse)
+  * [get_notes(code, search_in_ancestors=False, prioritize_blocks=False)](#get_notescode-search_in_ancestorsfalse-prioritize_blocksfalse)
   * [get_full_data(code, search_in_ancestors=False, prioritize_blocks=False)](#get_full_datacode-search_in_ancestorsfalse-prioritize_blocksfalse)
   * [get_parent(code, prioritize_blocks=False)](#get_parentcode-prioritize_blocksfalse)
   * [get_children(code, prioritize_blocks=False)](#get_childrencode-prioritize_blocksfalse)
@@ -45,6 +47,7 @@ A simple python library for ICD-10-CM codes
 * [Conclusion](#conclusion)
 
 ## Release notes
+* **1.4.0**: The data in the fields "codeAlso" and "notes" can now be retrieved using the get_code_also() and get_notes() functions
 * **1.3.0**:
   * Users can now use their preferred ICD-10-CM release by providing properly formatted files as inputs
   * The default ICD-10-CM release of the library is now the **April 2025 release**
@@ -64,7 +67,7 @@ The objective of this library is to provide a simple instrument for dealing with
 If you are looking for a library that deals with ICD-10 codes instead of ICD-10-CM codes, you can check the [simple_icd_10 library](https://github.com/StefanoTrv/simple_icd_10), which is based on the 2019 version of ICD-10. If you are interested in the ICD-11 MMS classification, you can check out instead the [simple_icd_11 library](https://github.com/StefanoTrv/simple_icd_11).  
 There is also a Java version of this library, [SimpleICD10CM-Java-edition](https://github.com/StefanoTrv/SimpleICD10CM-Java-edition).
 
-The data used in this library was taken from the [website of the CDC]((https://www.cdc.gov/nchs/icd/icd-10-cm/files.html). This library currently uses the **April 2025 release of ICD-10-CM**. This package can be configured to use other releases of the ICD-10-CM classification, read the section [Using other ICD-10-CM releases](#using-other-icd-10-cm-releases) for more details.
+The data used in this library was taken from the [website of the CDC](https://www.cdc.gov/nchs/icd/icd-10-cm/files.html). This library currently uses the **April 2025 release of ICD-10-CM**. This package can be configured to use other releases of the ICD-10-CM classification, read the section [Using other ICD-10-CM releases](#using-other-icd-10-cm-releases) for more details.
 
 If you feel like supporting me, please check out the [Conclusion section](#conclusion).
 
@@ -322,6 +325,30 @@ cm.get_code_first("S04.01")
 cm.get_code_first("S04.01",search_in_ancestors=True)
 #'any associated intracranial injury (S06.-)'
 ```
+### get_code_also(code, search_in_ancestors=False, prioritize_blocks=False)
+This function takes a string as input. If the string is a valid ICD-10-CM code, it returns a **string** containing the data of the "codeAlso" field of this code, otherwise it raises a ValueError. If this code does not have a "codeAlso" field, it returns an empty string. Please see [Instructional Notations](https://github.com/StefanoTrv/simple_icd_10_CM/blob/master/Instructional%20Notations.md) if you have doubts about the meaning of this field. When the optional argument `search_in_ancestors` is set to True, if the given code doesn't have a "codeAlso" field but one of its ancestor does, the "codeAlso" data of the closer ancestor that contains such a field is returned. For the meaning of the optional argument `prioritize_blocks`, please see [Blocks containing only one category](#blocks-containing-only-one-category).
+```python
+cm.get_code_also("I82.41")
+#''
+cm.get_code_also("Z23")
+#', if applicable, encounter for immunization safety counseling (Z71.85)'
+cm.get_code_also("Z49.0")
+#''
+cm.get_code_also("Z49.0",search_in_ancestors=True)
+#'associated end stage renal disease (N18.6)'
+```
+### get_notes(code, search_in_ancestors=False, prioritize_blocks=False)
+This function takes a string as input. If the string is a valid ICD-10-CM code, it returns a **string** containing the data of the "notes" field of this code, otherwise it raises a ValueError. If this code does not have a "notes" field, it returns an empty string. When the optional argument `search_in_ancestors` is set to True, if the given code doesn't have a "notes" field but one of its ancestor does, the "notes" data of the closer ancestor that contains such a field is returned. For the meaning of the optional argument `prioritize_blocks`, please see [Blocks containing only one category](#blocks-containing-only-one-category).
+```python
+cm.get_notes("I82.41")
+#''
+cm.get_notes("Z23")
+#'procedure codes are required to identify the types of immunizations given'
+cm.get_notes("C91.00")
+#''
+cm.get_notes("C91.00",search_in_ancestors=True)
+#'Codes in subcategory C91.0- should only be used for T-cell and B-cell precursor leukemia'
+```
 ### get_full_data(code, search_in_ancestors=False, prioritize_blocks=False)
 This function takes a string as input. If the string is a valid ICD-10-CM code, it returns a string containing all the available data of the code, otherwise it raises a ValueError. The empty fields are omitted from the string, except for the list of children (see second example below). When the optional argument `search_in_ancestors` is set to True, if the given code doesn't have a certain field but one of its ancestor does, the data of the closer ancestor that contains such a field is returned: see the previous functions to know which are the fields that are influenced by this argument and which are not. For the meaning of the optional argument `prioritize_blocks`, please see [Blocks containing only one category](#blocks-containing-only-one-category).
 ```python
@@ -464,7 +491,8 @@ If you find this library useful and are feeling generous, consider making a dona
 
 ---
 
-Paypal: [![Donate](https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif)](https://www.paypal.com/donate?hosted_button_id=9HMMFAZE248VN)
+[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/J3J81G2OSG)  
+[![Paypal](https://pics.paypal.com/00/s/NDU5Y2RmMjQtMTVmYi00MDIyLTgyMzMtMTFiNDY1MjUzMDA5/file.PNG)](https://www.paypal.com/donate?hosted_button_id=9HMMFAZE248VN)
 
 Curecoin: BKxCWuWzsqtLzAvAjtpsHpJ7LqFHPubqft
 

{simple_icd_10_cm-1.3.0 → simple_icd_10_cm-1.4.0}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setuptools.setup(
     name="simple_icd_10_cm",
-    version="1.3.0",
+    version="1.4.0",
     author="Stefano Travasci",
     author_email="stefanotravasci@gmail.com",
     description="A simple python library for ICD-10-CM codes",

{simple_icd_10_cm-1.3.0 → simple_icd_10_cm-1.4.0}/simple_icd_10_cm/simple_icd_10_cm.py

@@ -27,7 +27,7 @@ _all_codes_package_file_name:str = 'code-list-April-2025.txt'
 _classification_data_package_file_name:str = 'icd10cm-tabular-April-2025.xml'
 
 class _CodeTree:
-    def __init__(self, tree, parent = None, seven_chr_def_ancestor = None, seven_chr_note_ancestor = None, use_additional_code_ancestor = None, code_first_ancestor = None):
+    def __init__(self, tree, parent = None, seven_chr_def_ancestor = None, seven_chr_note_ancestor = None, use_additional_code_ancestor = None, code_first_ancestor = None, code_also_ancestor = None, notes_ancestor = None):
         #initialize all the values
         self.name = ""
         self.description = ""
@@ -46,17 +46,24 @@ class _CodeTree:
         self.use_additional_code_ancestor = use_additional_code_ancestor
         self.code_first = ""
         self.code_first_ancestor = code_first_ancestor
+        self.code_also = ""
+        self.code_also_ancestor = code_also_ancestor
+        self.notes = ""
+        self.notes_ancestor = notes_ancestor
         
         #reads the data from the subtrees
         new_seven_chr_def_ancestor=seven_chr_def_ancestor
         new_seven_chr_note_ancestor=seven_chr_note_ancestor
         new_use_additional_code_ancestor=use_additional_code_ancestor
         new_code_first_ancestor=code_first_ancestor
+        new_code_also_ancestor=code_also_ancestor
+        new_notes_ancestor=notes_ancestor
         if "id" in tree.attrib: #the name of sections is an attribute instead of text inside an XML element
             self.name=tree.attrib["id"]
         for subtree in tree:
             if subtree.tag=="section" or subtree.tag=="diag": #creates a new child for this node
-                self.children.append(_CodeTree(subtree,parent=self,seven_chr_def_ancestor=new_seven_chr_def_ancestor,seven_chr_note_ancestor=new_seven_chr_note_ancestor,use_additional_code_ancestor=new_use_additional_code_ancestor,code_first_ancestor=new_code_first_ancestor))
+                # This is only correct because the XML elements for the children codes always follow the XML elements for this code's data
+                self.children.append(_CodeTree(subtree,parent=self,seven_chr_def_ancestor=new_seven_chr_def_ancestor,seven_chr_note_ancestor=new_seven_chr_note_ancestor,use_additional_code_ancestor=new_use_additional_code_ancestor,code_first_ancestor=new_code_first_ancestor,code_also_ancestor=new_code_also_ancestor,notes_ancestor=new_notes_ancestor))
             elif subtree.tag=="name":
                 self.name=subtree.text
             elif subtree.tag=="desc":
@@ -86,6 +93,7 @@ class _CodeTree:
                 self.seven_chr_note=subtree[0].text
                 new_seven_chr_note_ancestor=self
             elif subtree.tag=="useAdditionalCode":
+            # NOTE: multiple useAdditionalCode elements may be present, so self.use_additional_code should always be appended and never overwritten
                 for i in range(0,len(subtree)):#in case there are multiple lines
                     self.use_additional_code=self.use_additional_code+"\n"+subtree[i].text
                 new_use_additional_code_ancestor=self
@@ -93,12 +101,26 @@ class _CodeTree:
                 for i in range(0,len(subtree)):#in case there are multiple lines
                     self.code_first=self.code_first+"\n"+subtree[i].text
                 new_code_first_ancestor=self
+            elif subtree.tag=="codeAlso":
+            # see NOTE for useAdditionalCode
+                for i in range(0,len(subtree)):#in case there are multiple lines
+                    self.code_also=self.code_also+"\n"+subtree[i].text
+                new_code_also_ancestor=self
+            elif subtree.tag=="notes":
+            # see NOTE for useAdditionalCode
+                for i in range(0,len(subtree)):#in case there are multiple lines
+                    self.notes=self.notes+"\n"+subtree[i].text
+                new_notes_ancestor=self
         
-        #cleans the use_additional_code and code_first fields from extra new lines
+        #cleans the use_additional_code, code_first, code_also and notes fields from extra new lines
         if self.use_additional_code!="" and self.use_additional_code[0]=="\n":
             self.use_additional_code=self.use_additional_code[1:]
         if self.code_first!="" and self.code_first[0]=="\n":
             self.code_first=self.code_first[1:]
+        if self.code_also!="" and self.code_also[0]=="\n":
+            self.code_also=self.code_also[1:]
+        if self.notes!="" and self.notes[0]=="\n":
+            self.notes=self.notes[1:]
         
         #sets the type
         if tree.tag=="chapter":
@@ -130,7 +152,7 @@ class _CodeTree:
             for extension in dictionary:
                 if((extended_name[:3]+extended_name[4:]+extension) in all_confirmed_codes):#checks if there's a special rule that excludes this new code
                     new_XML = "<diag_ext><name>"+extended_name+extension+"</name><desc>"+self.description+", "+dictionary[extension]+"</desc></diag_ext>"
-                    self.children.append(_CodeTree(ET.fromstring(new_XML),parent=self,seven_chr_def_ancestor=new_seven_chr_def_ancestor,seven_chr_note_ancestor=new_seven_chr_note_ancestor,use_additional_code_ancestor=new_use_additional_code_ancestor,code_first_ancestor=new_code_first_ancestor))
+                    self.children.append(_CodeTree(ET.fromstring(new_XML),parent=self,seven_chr_def_ancestor=new_seven_chr_def_ancestor,seven_chr_note_ancestor=new_seven_chr_note_ancestor,use_additional_code_ancestor=new_use_additional_code_ancestor,code_first_ancestor=new_code_first_ancestor,code_also_ancestor=new_code_also_ancestor,notes_ancestor=new_notes_ancestor))
 
 def _load_codes(all_codes_file_path:Optional[str] = None, classification_data_file_path:Optional[str] = None) -> None: # either both or none of the strings must be None
     #loads the list of all codes, to remove later from the tree the ones that do not exist for very specific rules not easily extracted from the XML file
@@ -324,6 +346,30 @@ def get_code_first(code:str, search_in_ancestors:bool=False, prioritize_blocks:b
     else:
         return res
 
+def get_code_also(code:str, search_in_ancestors:bool=False, prioritize_blocks:bool=False) -> str:
+    if not is_valid_item(code):
+        raise ValueError("The code \""+code+"\" does not exist.")
+    node = _code_to_node[_add_dot_to_code(code)]
+    if prioritize_blocks and node.parent!=None and node.parent.name==node.name:
+        node = node.parent
+    res = node.code_also
+    if search_in_ancestors and res=="" and node.code_also_ancestor!=None:
+        return node.code_also_ancestor.code_also
+    else:
+        return res
+
+def get_notes(code:str, search_in_ancestors:bool=False, prioritize_blocks:bool=False) -> str:
+    if not is_valid_item(code):
+        raise ValueError("The code \""+code+"\" does not exist.")
+    node = _code_to_node[_add_dot_to_code(code)]
+    if prioritize_blocks and node.parent!=None and node.parent.name==node.name:
+        node = node.parent
+    res = node.notes
+    if search_in_ancestors and res=="" and node.notes_ancestor!=None:
+        return node.notes_ancestor.notes
+    else:
+        return res
+
 def get_parent(code:str, prioritize_blocks:bool=False) -> str:
     if not is_valid_item(code):
         raise ValueError("The code \""+code+"\" does not exist.")
@@ -393,6 +439,12 @@ def get_full_data(code:str, search_in_ancestors:bool=False, prioritize_blocks:bo
     code_first=get_code_first(code,search_in_ancestors=search_in_ancestors,prioritize_blocks=prioritize_blocks)
     if code_first!="":
         str = str + "\ncode first:\n" + code_first
+    code_also=get_code_also(code,search_in_ancestors=search_in_ancestors,prioritize_blocks=prioritize_blocks)
+    if code_also!="":
+        str = str + "\ncode also:\n" + code_also
+    notes=get_notes(code,search_in_ancestors=search_in_ancestors,prioritize_blocks=prioritize_blocks)
+    if notes!="":
+        str = str + "\nnotes:\n" + notes
     if node.children==[]:
         str = str + "\nChildren:\nNone--"
     else:

{simple_icd_10_cm-1.3.0 → simple_icd_10_cm-1.4.0/simple_icd_10_cm.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simple_icd_10_cm
-Version: 1.3.0
+Version: 1.4.0
 Summary: A simple python library for ICD-10-CM codes
 Home-page: https://github.com/StefanoTrv/simple_icd_10_CM
 Author: Stefano Travasci
@@ -53,6 +53,8 @@ A simple python library for ICD-10-CM codes
   * [get_seven_chr_def(code, search_in_ancestors=False, prioritize_blocks=False)](#get_seven_chr_defcode-search_in_ancestorsfalse-prioritize_blocksfalse)
   * [get_use_additional_code(code, search_in_ancestors=False, prioritize_blocks=False)](#get_use_additional_codecode-search_in_ancestorsfalse-prioritize_blocksfalse)
   * [get_code_first(code, search_in_ancestors=False, prioritize_blocks=False)](#get_code_firstcode-search_in_ancestorsfalse-prioritize_blocksfalse)
+  * [get_code_also(code, search_in_ancestors=False, prioritize_blocks=False)](#get_code_alsocode-search_in_ancestorsfalse-prioritize_blocksfalse)
+  * [get_notes(code, search_in_ancestors=False, prioritize_blocks=False)](#get_notescode-search_in_ancestorsfalse-prioritize_blocksfalse)
   * [get_full_data(code, search_in_ancestors=False, prioritize_blocks=False)](#get_full_datacode-search_in_ancestorsfalse-prioritize_blocksfalse)
   * [get_parent(code, prioritize_blocks=False)](#get_parentcode-prioritize_blocksfalse)
   * [get_children(code, prioritize_blocks=False)](#get_childrencode-prioritize_blocksfalse)
@@ -70,6 +72,7 @@ A simple python library for ICD-10-CM codes
 * [Conclusion](#conclusion)
 
 ## Release notes
+* **1.4.0**: The data in the fields "codeAlso" and "notes" can now be retrieved using the get_code_also() and get_notes() functions
 * **1.3.0**:
   * Users can now use their preferred ICD-10-CM release by providing properly formatted files as inputs
   * The default ICD-10-CM release of the library is now the **April 2025 release**
@@ -89,7 +92,7 @@ The objective of this library is to provide a simple instrument for dealing with
 If you are looking for a library that deals with ICD-10 codes instead of ICD-10-CM codes, you can check the [simple_icd_10 library](https://github.com/StefanoTrv/simple_icd_10), which is based on the 2019 version of ICD-10. If you are interested in the ICD-11 MMS classification, you can check out instead the [simple_icd_11 library](https://github.com/StefanoTrv/simple_icd_11).  
 There is also a Java version of this library, [SimpleICD10CM-Java-edition](https://github.com/StefanoTrv/SimpleICD10CM-Java-edition).
 
-The data used in this library was taken from the [website of the CDC]((https://www.cdc.gov/nchs/icd/icd-10-cm/files.html). This library currently uses the **April 2025 release of ICD-10-CM**. This package can be configured to use other releases of the ICD-10-CM classification, read the section [Using other ICD-10-CM releases](#using-other-icd-10-cm-releases) for more details.
+The data used in this library was taken from the [website of the CDC](https://www.cdc.gov/nchs/icd/icd-10-cm/files.html). This library currently uses the **April 2025 release of ICD-10-CM**. This package can be configured to use other releases of the ICD-10-CM classification, read the section [Using other ICD-10-CM releases](#using-other-icd-10-cm-releases) for more details.
 
 If you feel like supporting me, please check out the [Conclusion section](#conclusion).
 
@@ -347,6 +350,30 @@ cm.get_code_first("S04.01")
 cm.get_code_first("S04.01",search_in_ancestors=True)
 #'any associated intracranial injury (S06.-)'
 ```
+### get_code_also(code, search_in_ancestors=False, prioritize_blocks=False)
+This function takes a string as input. If the string is a valid ICD-10-CM code, it returns a **string** containing the data of the "codeAlso" field of this code, otherwise it raises a ValueError. If this code does not have a "codeAlso" field, it returns an empty string. Please see [Instructional Notations](https://github.com/StefanoTrv/simple_icd_10_CM/blob/master/Instructional%20Notations.md) if you have doubts about the meaning of this field. When the optional argument `search_in_ancestors` is set to True, if the given code doesn't have a "codeAlso" field but one of its ancestor does, the "codeAlso" data of the closer ancestor that contains such a field is returned. For the meaning of the optional argument `prioritize_blocks`, please see [Blocks containing only one category](#blocks-containing-only-one-category).
+```python
+cm.get_code_also("I82.41")
+#''
+cm.get_code_also("Z23")
+#', if applicable, encounter for immunization safety counseling (Z71.85)'
+cm.get_code_also("Z49.0")
+#''
+cm.get_code_also("Z49.0",search_in_ancestors=True)
+#'associated end stage renal disease (N18.6)'
+```
+### get_notes(code, search_in_ancestors=False, prioritize_blocks=False)
+This function takes a string as input. If the string is a valid ICD-10-CM code, it returns a **string** containing the data of the "notes" field of this code, otherwise it raises a ValueError. If this code does not have a "notes" field, it returns an empty string. When the optional argument `search_in_ancestors` is set to True, if the given code doesn't have a "notes" field but one of its ancestor does, the "notes" data of the closer ancestor that contains such a field is returned. For the meaning of the optional argument `prioritize_blocks`, please see [Blocks containing only one category](#blocks-containing-only-one-category).
+```python
+cm.get_notes("I82.41")
+#''
+cm.get_notes("Z23")
+#'procedure codes are required to identify the types of immunizations given'
+cm.get_notes("C91.00")
+#''
+cm.get_notes("C91.00",search_in_ancestors=True)
+#'Codes in subcategory C91.0- should only be used for T-cell and B-cell precursor leukemia'
+```
 ### get_full_data(code, search_in_ancestors=False, prioritize_blocks=False)
 This function takes a string as input. If the string is a valid ICD-10-CM code, it returns a string containing all the available data of the code, otherwise it raises a ValueError. The empty fields are omitted from the string, except for the list of children (see second example below). When the optional argument `search_in_ancestors` is set to True, if the given code doesn't have a certain field but one of its ancestor does, the data of the closer ancestor that contains such a field is returned: see the previous functions to know which are the fields that are influenced by this argument and which are not. For the meaning of the optional argument `prioritize_blocks`, please see [Blocks containing only one category](#blocks-containing-only-one-category).
 ```python
@@ -489,7 +516,8 @@ If you find this library useful and are feeling generous, consider making a dona
 
 ---
 
-Paypal: [![Donate](https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif)](https://www.paypal.com/donate?hosted_button_id=9HMMFAZE248VN)
+[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/J3J81G2OSG)  
+[![Paypal](https://pics.paypal.com/00/s/NDU5Y2RmMjQtMTVmYi00MDIyLTgyMzMtMTFiNDY1MjUzMDA5/file.PNG)](https://www.paypal.com/donate?hosted_button_id=9HMMFAZE248VN)
 
 Curecoin: BKxCWuWzsqtLzAvAjtpsHpJ7LqFHPubqft