jsongrapher 3.8__py3-none-any.whl → 4.1__py3-none-any.whl

JSONGrapher/JSONRecordCreator.py

@@ -1,6 +1,7 @@
 import json
 import JSONGrapher.styles.layout_styles_library
 import JSONGrapher.styles.trace_styles_collection_library
+import JSONGrapher.version
 #TODO: put an option to suppress warnings from JSONRecordCreator
 
 
@@ -607,6 +608,7 @@ class JSONGrapherRecord:
 
         self.fig_dict.update( {
             "comments": comments,  # Top-level comments
+            "jsongrapher": "To plot this file, go to www.jsongrapher.com and drag this file into your browser, or use the python version of JSONGrapher. File created with python Version " + JSONGrapher.version.__version__,
             "datatype": datatype,  # Top-level datatype (datatype)
             "data": data_objects_list if data_objects_list else [],  # Data series list
             "layout": layout if layout else {
@@ -831,7 +833,8 @@ class JSONGrapherRecord:
     def evaluate_eqution_of_data_series_by_index(self, series_index, equation_dict = None, verbose=False):
         if equation_dict != None:
             self.fig_dict["data"][series_index]["equation"] = equation_dict
-        self.fig_dict = evaluate_equation_for_data_series_by_index(data_series_index=data_series_dict, verbose=verbose) #implied return.
+        data_series_dict = self.fig_dict["data"][series_index]
+        self.fig_dict = evaluate_equation_for_data_series_by_index(fig_dict=self.fig_dict, data_series_index=data_series_dict, verbose=verbose) #implied return.
         return data_series_dict #Extra regular return
 
     #this function returns the current record.       
@@ -842,11 +845,11 @@ class JSONGrapherRecord:
         return self.fig_dict
     #The update_and_validate function will clean for plotly.
     #TODO: the internal recommending "print_to_inspect" function should, by default, exclude printing the full dictionaries of the layout_style and the trace_collection_style.
-    def print_to_inspect(self, update_and_validate=True, validate=True, remove_remaining_hints=False):
+    def print_to_inspect(self, update_and_validate=True, validate=True, clean_for_plotly = True, remove_remaining_hints=False):
         if remove_remaining_hints == True:
             self.remove_hints()
         if update_and_validate == True: #this will do some automatic 'corrections' during the validation.
-            self.update_and_validate_JSONGrapher_record()
+            self.update_and_validate_JSONGrapher_record(clean_for_plotly=clean_for_plotly)
         elif validate: #this will validate without doing automatic updates.
             self.validate_JSONGrapher_record()
         print(json.dumps(self.fig_dict, indent=4))
@@ -896,14 +899,39 @@ class JSONGrapherRecord:
         #now, add the scaled data objects to the original one.
         #This is fairly easy using a list extend.
         self.fig_dict["data"].extend(scaled_fig_dict["data"])
-
-
-    
+   
     def import_from_dict(self, fig_dict):
         self.fig_dict = fig_dict
     
-    def import_from_file(self, json_filename_or_object):
-        self.import_from_json(json_filename_or_object)
+    def import_from_file(self, record_filename_or_object):
+        """
+        Determine the type of file or data and call the appropriate import function.
+
+        Args:
+            record_filename_or_object (str or dict): Filename of the CSV/TSV/JSON file or a dictionary object.
+
+        Returns:
+            dict: Processed JSON data.
+        """
+        import os  # Moved inside the function
+
+        # If the input is a dictionary, process it as JSON
+        if isinstance(record_filename_or_object, dict):
+            result = self.import_from_json(record_filename_or_object)
+        else:
+            # Determine file extension
+            file_extension = os.path.splitext(record_filename_or_object)[1].lower()
+
+            if file_extension == ".csv":
+                result = self.import_from_csv(record_filename_or_object, delimiter=",")
+            elif file_extension == ".tsv":
+                result = self.import_from_csv(record_filename_or_object, delimiter="\t")
+            elif file_extension == ".json":
+                result = self.import_from_json(record_filename_or_object)
+            else:
+                raise ValueError("Unsupported file type. Please provide a CSV, TSV, or JSON file.")
+
+        return result
 
     #the json object can be a filename string or can be json object which is actually a dictionary.
     def import_from_json(self, json_filename_or_object):
@@ -929,6 +957,63 @@ class JSONGrapherRecord:
             self.fig_dict = json_filename_or_object
             return self.fig_dict
 
+    def import_from_csv(self, filename, delimiter=","):
+        """
+        Convert CSV file content into a JSON structure for Plotly.
+
+        Args:
+            filename (str): Path to the CSV file.
+            delimiter (str, optional): Delimiter used in CSV. Default is ",".
+                                    Use "\\t" for a tab-delimited file.
+
+        Returns:
+            dict: JSON representation of the CSV data.
+        """
+        import os  
+        # Modify the filename based on the delimiter and existing extension
+        file_extension = os.path.splitext(filename)[1]
+        if delimiter == "," and not file_extension:  # No extension present
+            filename += ".csv"
+        elif delimiter == "\t" and not file_extension:  # No extension present
+            filename += ".tsv"
+        with open(filename, "r", encoding="utf-8") as file:
+            file_content = file.read().strip()
+        # Separate rows
+        arr = file_content.split("\n")
+        # Count number of columns
+        number_of_columns = len(arr[5].split(delimiter))
+        # Extract config information
+        comments = arr[0].split(delimiter)[0].split(":")[1].strip()
+        datatype = arr[1].split(delimiter)[0].split(":")[1].strip()
+        chart_label = arr[2].split(delimiter)[0].split(":")[1].strip()
+        x_label = arr[3].split(delimiter)[0].split(":")[1].strip()
+        y_label = arr[4].split(delimiter)[0].split(":")[1].strip()
+        # Extract series names
+        series_names_array = [
+            n.strip()
+            for n in arr[5].split(":")[1].split('"')[0].split(delimiter)
+            if n.strip()
+        ]
+        # Extract data
+        data = [[float(str_val) for str_val in row.split(delimiter)] for row in arr[8:]]
+        self.fig_dict["comments"] = comments
+        self.fig_dict["datatype"] = datatype
+        self.fig_dict["layout"]["title"] = {"text": chart_label}
+        self.fig_dict["layout"]["xaxis"]["title"] = {"text": x_label}
+        self.fig_dict["layout"]["yaxis"]["title"] = {"text": y_label}
+        # Create series datasets
+        new_data = []
+        for index, series_name in enumerate(series_names_array):
+            data_series_dict = {}
+            data_series_dict["name"] = series_name
+            data_series_dict["x"] = [row[0] for row in data]
+            data_series_dict["y"] = [row[index + 1] for row in data]
+            data_series_dict["uid"] = str(index)
+            new_data.append(data_series_dict)
+        self.fig_dict["data"] = new_data
+        self.fig_dict = self.fig_dict
+        return self.fig_dict 
+
     def set_datatype(self, datatype):
         """
         Sets the datatype field used as the experiment type or schema identifier.
@@ -1047,7 +1132,7 @@ class JSONGrapherRecord:
         elif validate: #this will validate without doing automatic updates.
             self.validate_JSONGrapher_record()
 
-        # filepath: Optional, filename with path to save the JSON file.       
+        # filename with path to save the JSON file.       
         if len(filename) > 0: #this means we will be writing to file.
             # Check if the filename has an extension and append `.json` if not
             if '.json' not in filename.lower():
@@ -1057,6 +1142,18 @@ class JSONGrapherRecord:
                 json.dump(self.fig_dict, f, indent=4)
         return self.fig_dict
 
+    def export_plotly_json(self, filename, plot_style = None, update_and_validate=True, simulate_all_series=True, evaluate_all_equations=True,adjust_implicit_data_ranges=True):
+        fig = self.get_plotly_fig(plot_style=plot_style, update_and_validate=update_and_validate, simulate_all_series=simulate_all_series, evaluate_all_equations=evaluate_all_equations, adjust_implicit_data_ranges=adjust_implicit_data_ranges)
+        plotly_json_string = fig.to_plotly_json()
+        if len(filename) > 0: #this means we will be writing to file.
+            # Check if the filename has an extension and append `.json` if not
+            if '.json' not in filename.lower():
+                filename += ".json"
+            #Write to file using UTF-8 encoding.
+            with open(filename, 'w', encoding='utf-8') as f:
+                json.dump(plotly_json_string, f, indent=4)
+        return plotly_json_string
+
     #simulate all series will simulate any series as needed.
     def get_plotly_fig(self, plot_style=None, update_and_validate=True, simulate_all_series=True, evaluate_all_equations=True, adjust_implicit_data_ranges=True):
         """
@@ -1092,8 +1189,8 @@ class JSONGrapherRecord:
         self.apply_plot_style(plot_style=plot_style)
         #Now we clean out the fields and make a plotly object.
         if update_and_validate == True: #this will do some automatic 'corrections' during the validation.
-            self.update_and_validate_JSONGrapher_record() #this is the line that cleans "self.fig_dict"
-            self.fig_dict = clean_json_fig_dict(self.fig_dict, fields_to_update=['simulate', 'custom_units_chevrons', 'equation', 'trace_style', '3d_axes', 'bubble'])
+            self.update_and_validate_JSONGrapher_record(clean_for_plotly=False) #We use the False argument here because the cleaning will be on the next line with beyond default arguments.
+            self.fig_dict = clean_json_fig_dict(self.fig_dict, fields_to_update=['simulate', 'custom_units_chevrons', 'equation', 'trace_style', '3d_axes', 'bubble', 'superscripts'])
         fig = pio.from_json(json.dumps(self.fig_dict))
         #restore the original fig_dict.
         self.fig_dict = original_fig_dict 
@@ -1390,8 +1487,8 @@ class JSONGrapherRecord:
     #Make some pointers to external functions, for convenience, so people can use syntax like record.function_name() if desired.
     def validate_JSONGrapher_record(self):
         validate_JSONGrapher_record(self)
-    def update_and_validate_JSONGrapher_record(self):
-        update_and_validate_JSONGrapher_record(self)
+    def update_and_validate_JSONGrapher_record(self, clean_for_plotly=True):
+        update_and_validate_JSONGrapher_record(self, clean_for_plotly=clean_for_plotly)
 
 
 # helper function to validate x axis and y axis labels.
@@ -2040,14 +2137,14 @@ def apply_trace_style_to_single_data_series(data_series, trace_styles_collection
         data_series["trace_style"] = trace_style_to_apply
     elif str(trace_style_to_apply) == str(''): #If we received an empty string for the trace_style_to apply (default JSONGrapher flow), we'll check in the data_series object.   
         #first see if there is a trace_style in the data_series.
-        trace_style = data_series.get("trace_style", "")
+        trace_style_to_apply = data_series.get("trace_style", "")
         #If it's "none", then we'll return the data series unchanged.
         #We consider it that for every trace_styles_collection, that "none" means to make no change.
-        if str(trace_style).lower() == "none":
+        if str(trace_style_to_apply).lower() == "none":
             return data_series
         #if we find a dictionary, we will set the trace_style_to_apply to that, to ensure we skip other string checks to use the dictionary.
-        if isinstance(trace_style,dict):
-            trace_style_to_apply = trace_style
+        if isinstance(trace_style_to_apply,dict):
+            trace_style_to_apply = trace_style_to_apply
     #if the trace_style_to_apply is a string and we have not received a trace_styles collection, then we have nothing
     #to use, so will return the data_series unchanged.
     if type(trace_style_to_apply) == type("string"):
@@ -2060,6 +2157,16 @@ def apply_trace_style_to_single_data_series(data_series, trace_styles_collection
     if type(trace_style_to_apply) == type("string"):
         if (trace_style_to_apply.lower() == "nature") or (trace_style_to_apply.lower() == "science"):
             trace_style_to_apply = "default"
+    #Because the 3D traces will not plot correctly unless recognized,
+    #we have a hardcoded case for the situation that 3D dataset is received without plot style.
+    if trace_styles_collection == "default":
+        if trace_style_to_apply == "":
+            if data_series.get("z", '') != '':
+                trace_style_to_apply = "scatter3d"
+                uid = data_series.get('uid', '')
+                name = data_series.get("name", '')
+                print("Warning: A dataseries was found with no trace_style but with a 'z' field. " , "uid: " , uid ,  " . " + "name:",  name ,  " . The trace style for this dataseries is being set to scatter3d.")
+
 
     #at this stage, should remove any existing formatting before applying new formatting.
     data_series = remove_trace_style_from_single_data_series(data_series)
@@ -2099,12 +2206,12 @@ def apply_trace_style_to_single_data_series(data_series, trace_styles_collection
         trace_style = data_series.get("trace_style", "")
     else:
         trace_style = trace_style_to_apply
-
     if trace_style == "": #if the trace style is an empty string....
         trace_style = list(styles_collection_dict.keys())[0] #take the first trace_style name in the style_dict.  In python 3.7 and later dictionary keys preserve ordering.
 
     #If a person adds "__colorscale" to the end of a trace_style, like "scatter_spline__rainbow" we will extract the colorscale and apply it to the plot.
     #This should be done before extracting the trace_style from the styles_available, because we need to split the string to break out the trace_style
+    #Also should be initialized before determining the second half of colorscale_structure checks (which occurs after the trace_style application), since it affects that logic.
     colorscale = "" #initializing variable.
     if isinstance(trace_style, str): #check if it is a string type.
         if "__" in trace_style:
@@ -2928,24 +3035,61 @@ def get_fig_dict_ranges(fig_dict, skip_equations=False, skip_simulations=False):
 
 ### Start section of code with functions for cleaning fig_dicts for plotly compatibility ###
 
-def update_title_field(fig_dict, depth=1, max_depth=10):
+def update_title_field(fig_dict_or_subdict, depth=1, max_depth=10):
     """ This function is intended to make JSONGrapher .json files compatible with the newer plotly recommended title field formatting
     which is necessary to do things like change the font, and also necessary for being able to convert a JSONGrapher json_dict to python plotly figure objects.
     Recursively checks for 'title' fields and converts them to dictionary format. """
-    if depth > max_depth or not isinstance(fig_dict, dict):
-        return fig_dict
+    if depth > max_depth or not isinstance(fig_dict_or_subdict, dict):
+        return fig_dict_or_subdict
     
-    for key, value in fig_dict.items():
-        if key == "title" and isinstance(value, str):
-            fig_dict[key] = {"text": value}
+    for key, value in fig_dict_or_subdict.items():
+        if key == "title" and isinstance(value, str):  #This is for axes labels.
+            fig_dict_or_subdict[key] = {"text": value}
         elif isinstance(value, dict):  # Nested dictionary
-            fig_dict[key] = update_title_field(value, depth + 1, max_depth)
+            fig_dict_or_subdict[key] = update_title_field(value, depth + 1, max_depth)
         elif isinstance(value, list):  # Lists can contain nested dictionaries
-            fig_dict[key] = [update_title_field(item, depth + 1, max_depth) if isinstance(item, dict) else item for item in value]
-    return fig_dict
+            fig_dict_or_subdict[key] = [update_title_field(item, depth + 1, max_depth) if isinstance(item, dict) else item for item in value]
+    return fig_dict_or_subdict
+
+
 
 
+def update_superscripts_strings(fig_dict_or_subdict, depth=1, max_depth=10):
+    """ This function is intended to make JSONGrapher .json files compatible with the newer plotly recommended title field formatting
+    which is necessary to do things like change the font, and also necessary for being able to convert a JSONGrapher json_dict to python plotly figure objects.
+    Recursively checks for 'title' fields and converts them to dictionary format. """
+    if depth > max_depth or not isinstance(fig_dict_or_subdict, dict):
+        return fig_dict_or_subdict
+    
+    for key, value in fig_dict_or_subdict.items():
+        if key == "title": #This is for axes labels and graph title.
+            if "text" in fig_dict_or_subdict[key]:
+                fig_dict_or_subdict[key]["text"] = replace_superscripts(fig_dict_or_subdict[key]["text"])
+        if key == "data": #This is for the legend.
+            for data_dict in fig_dict_or_subdict[key]:
+                if "name" in data_dict:
+                    data_dict["name"] = replace_superscripts(data_dict["name"])
+        elif isinstance(value, dict):  # Nested dictionary
+            fig_dict_or_subdict[key] = update_superscripts_strings(value, depth + 1, max_depth)
+        elif isinstance(value, list):  # Lists can contain nested dictionaries
+            fig_dict_or_subdict[key] = [update_superscripts_strings(item, depth + 1, max_depth) if isinstance(item, dict) else item for item in value]
+    return fig_dict_or_subdict
 
+#The below function was made with the help of copilot.
+def replace_superscripts(input_string):
+    #Example usage: print(replace_superscripts("x^(2) + y**(-3) = z^(test)"))
+    import re
+    # Step 1: Wrap superscript expressions in <sup> tags
+    output_string = re.sub(r'\^\((.*?)\)|\*\*\((.*?)\)', 
+                           lambda m: f"<sup>{m.group(1) or m.group(2)}</sup>", 
+                           input_string)
+    # Step 2: Remove parentheses if the content is only digits
+    output_string = re.sub(r'<sup>\((\d+)\)</sup>', r'<sup>\1</sup>', output_string)
+    # Step 3: Remove parentheses if the content is a negative number (- followed by digits)
+    # Step 4: Remove parentheses if the superscript is a single letter
+    output_string = re.sub(r'<sup>\((\w)\)</sup>', r'<sup>\1</sup>', output_string)
+    output_string = re.sub(r'<sup>\(-(\d+)\)</sup>', r'<sup>-\1</sup>', output_string)
+    return output_string
 
 
 def convert_to_3d_layout(layout):
@@ -3089,6 +3233,7 @@ def clean_json_fig_dict(json_fig_dict, fields_to_update=None):
      because one would not want to do that by mistake before simulation is performed.
      This function can also remove the 'equation' field from data series. However, that is not the default behavior
      because one would not want to do that by mistake before the equation is evaluated.
+     The "superscripts" option is not normally used until right before plotting because that will affect unit conversions.
      """
     if fields_to_update is None:  # should not initialize mutable objects in arguments line, so doing here.
         fields_to_update = ["title_field", "extraInformation", "nested_comments"]
@@ -3112,6 +3257,8 @@ def clean_json_fig_dict(json_fig_dict, fields_to_update=None):
         fig_dict = remove_trace_style_field(fig_dict)
     if "3d_axes" in fields_to_update: #This is for 3D plots
         fig_dict = update_3d_axes(fig_dict)
+    if "superscripts" in fields_to_update:
+        fig_dict = update_superscripts_strings(fig_dict)
 
     return fig_dict
 

JSONGrapher/__init__.py

@@ -1,3 +1,4 @@
 #Try to do things a bit like https://github.com/python/cpython/blob/master/Lib/collections/__init__.py
 #Except instead of putting things here directly in __init__, we'll import them so they are accessible by importing the module.
 from JSONGrapher.JSONRecordCreator import *
+from JSONGrapher.version import *

JSONGrapher/equation_evaluator.py

@@ -446,6 +446,8 @@ def split_at_first_delimiter(string, delimter=" "):
 #I would still expect the optimzed code to be an order of magnitude faster. So it may be worth finding the slow steps.
 #One possibility might be to use "re.compile()"
 def evaluate_equation_dict(equation_dict, verbose=False):
+    import copy
+    equation_dict = copy.deepcopy(equation_dict)  # Create a deep copy to prevent unintended modifications
     #First a block of code to extract the x_points needed
     # Extract each dictionary key as a local variable
     equation_string = equation_dict['equation_string']
@@ -479,21 +481,28 @@ def evaluate_equation_dict(equation_dict, verbose=False):
 
     #Start of block to check for any custom units and add them to the ureg if necessary.
     custom_units_list = []
+    #helper function to clean custom units brackets. In future, could be made more general rather than hardcoded as angle brackets.
+    def clean_brackets(string):
+        return string.replace("<", "").replace(">", "")
+
     for constant_entry_key in independent_variables_dict.keys():
         independent_variables_string = independent_variables_dict[constant_entry_key]
         custom_units_extracted = extract_tagged_strings(independent_variables_string)
+        independent_variables_dict[constant_entry_key] = clean_brackets(independent_variables_dict[constant_entry_key])
         for custom_unit in custom_units_extracted: #this will be skipped if the list is empty.
             ureg.define(f"{custom_unit} = [custom]") #use "[custom]" to create a custom unit in the pint module.
         custom_units_list.extend(custom_units_extracted)
       
     #now also check for the x_variable_extracted_dict 
     custom_units_extracted = extract_tagged_strings(x_variable_extracted_dict["units"])
+    x_variable_extracted_dict["units"] = clean_brackets(x_variable_extracted_dict["units"])
     for custom_unit in custom_units_extracted: #this will be skipped if the list is empty.
         ureg.define(f"{custom_unit} = [custom]") #use "[custom]" to create a custom unit in the pint module.
     custom_units_list.extend(custom_units_extracted)
 
     #now also check for the y_variable_extracted_dict (technically not needed)
     custom_units_extracted = extract_tagged_strings(y_variable_extracted_dict["units"])
+    y_variable_extracted_dict["units"] = clean_brackets(y_variable_extracted_dict["units"])
     for custom_unit in custom_units_extracted: #this will be skipped if the list is empty.
         ureg.define(f"{custom_unit} = [custom]") #use "[custom]" to create a custom unit in the pint module.
     custom_units_list.extend(custom_units_extracted)
@@ -501,18 +510,24 @@ def evaluate_equation_dict(equation_dict, verbose=False):
     if graphical_dimensionality == 3:
         #now also check for the z_variable_extracted_dict (technically not needed)
         custom_units_extracted = extract_tagged_strings(z_variable_extracted_dict["units"])
+        z_variable_extracted_dict["units"] = clean_brackets(z_variable_extracted_dict["units"])
         for custom_unit in custom_units_extracted: #this will be skipped if the list is empty.
             ureg.define(f"{custom_unit} = [custom]") #use "[custom]" to create a custom unit in the pint module.
         custom_units_list.extend(custom_units_extracted)
 
     #now also check for the equation_string
     custom_units_extracted = extract_tagged_strings(equation_string)
+    equation_string = clean_brackets(equation_string)
     for custom_unit in custom_units_extracted: #this will be skipped if the list is empty.
         ureg.define(f"{custom_unit} = [custom]") #use "[custom]" to create a custom unit in the pint module.
     custom_units_list.extend(custom_units_extracted)        
     
+    # Remove duplicates by converting to a set and back to a list.
+    custom_units_list = list(set(custom_units_list))
     #now sort from longest to shortest, since we will have to put them back in that way later.
+    # Sort the unique units by length in descending order
     custom_units_list = sorted(custom_units_list, key=len, reverse=True)
+
     #End of block to check for any custom units and add them to the ureg if necessary.
 
     #For graphical_dimensionality of 2, The full list of independent variables includes the x_variable and the independent_variables. 

JSONGrapher/version.py

@@ -0,0 +1 @@
+__version__ = '4.1'

jsongrapher-3.8.data/data/LICENSE → jsongrapher-4.1.data/data/LICENSE.txt

@@ -1,3 +1,5 @@
+BSD 3-Clause License
+
 Copyright 2025 Aditya Savara
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

{jsongrapher-3.8.data → jsongrapher-4.1.data}/data/README.md

@@ -1,26 +1,28 @@
+[![Anaconda-Server Badge](https://anaconda.org/conda-forge/jsongrapher/badges/version.svg)](https://anaconda.org/conda-forge/jsongrapher) [![Anaconda-Server Badge](https://badge.fury.io/py/jsongrapher.svg)](https://badge.fury.io/py/jsongrapher)
+
 # JSONGrapher (python)
-This is the python version of JSONGrapher with JSONRecordCreator. This package is for plotting JSON records with drag and drop and has tools for creating the JSON records.
 
-The software will automatically plot multiple records together, for comparison, and will automaticlaly converting units between records as needed to plot them for comparison (like kg/s and g/s).
+Imagine a world where a person can simply drag a datafile into a graphing utility and a plot will be made, including scientific units, and more plots can be dragged in from data from other sources (and other units) to compare all of the data together, in an interactive graph.
+
+Create interactive plots just by drag-and-drop of JSON records. Share the json files for easy plotting by others. JSONGrapher automatically plots multiple records together, for comparison, and will automaticlaly convert units between records to plot the data sets together. For example, if one record is in kg/s and another in g/s, JSONGrapher will do the conversion automatically to plot both records together for comparison. Tools and examples are included for how to create JSON records.
 
 To use python JSONGrapher, first install it using conda or pip:<br>
 `pip install JSONGrapher[COMPLETE]` or `conda install conda-forge::jsongrapher` <br>
 Alternatively, you can download the directory directly.<br> 
 
 ## **0\. Plotting a JSON Record**
-It's as simple as one line! Then drag an [example](https://github.com/AdityaSavara/jsongrapher-py/tree/main/examples/example_1_drag_and_drop) JSONGrapher record into the window to plot!
-Below shows several plot types for 2D and 3D plots, followed by a simple example of how to use python JSONGrapher to create your own records.
+To create an interactive plot, you just need one line of code! Then drag an [example](https://github.com/AdityaSavara/jsongrapher-py/tree/main/examples/example_1_drag_and_drop) JSONGrapher record into the window to plot!
+Below are example 2D and 3D plots. Further below shows how easy it is to create your own json records.
 <pre>
-import JSONGrapher 
-JSONGrapher.launch()
+import JSONGrapher; JSONGrapher.launch()
 </pre>
 
-[![JSONGRapher window](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/JSONGrapher/JSONGrapherWindowShortened.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/JSONGrapher/JSONGrapherWindowShortened.png) [![JSONGRapher plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/UAN_DTA_image.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/UAN_DTA_image.png)
+[![JSONGRapher window](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/JSONGrapher/JSONGrapherWindowShortened.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/JSONGrapher/JSONGrapherWindowShortened.png) [![JSONGRapher plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/UAN_DTA_image.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/UAN_DTA_image.png)
 
-[![rainbow plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/SrTiO3_rainbow_image.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/SrTiO3_rainbow_image.png)
-[![mesh3d plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/Rate_Constant_mesh3d.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/Rate_Constant_mesh3d.png)
-[![scatter3d plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/Rate_Constant_Scatter3d_example10.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/Rate_Constant_Scatter3d_example10.png)
-[![bubble plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/Rate_Constant_bubble.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/Rate_Constant_bubble.png)
+[![rainbow plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/SrTiO3_rainbow_image.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/SrTiO3_rainbow_image.png)
+[![mesh3d plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_mesh3d.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_mesh3d.png)
+[![scatter3d plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_Scatter3d_example10.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_Scatter3d_example10.png)
+[![bubble plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_bubble.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_bubble.png)
 
 
 
@@ -98,4 +100,15 @@ Record.plot_with_plotly() #Try hovering your mouse over points after this comman
 You can also see more examples: https://github.com/AdityaSavara/jsongrapher-py/tree/main/examples
 
 Additionally, json records you send to others can be plotted by them at www.jsongrapher.com
-This 'see the plot using a browser' capability is intended to facilitate including JSONGrapher records in supporting information of scientific publications.
+This 'see the plot using a browser' capability is intended to facilitate including JSONGrapher records in supporting information of scientific publications.
+
+
+## **Contributing to JSONGrapher, Feature Suggestions, and Reporting Issues**
+
+These interactions should be through github at https://github.com/AdityaSavara/jsongrapher-py
+
+To contribute to JSONGrapher, make a pull request with sufficient details about what issue you are trying to solve, and adequate commenting in your code to follow the logic. After that, be prepared for further communication if needed.
+
+To suggest features, create a new issue under the issues tab.
+
+To report issues, create a new issue under the issues tab.

jsongrapher-3.8.dist-info/LICENSE → jsongrapher-4.1.dist-info/LICENSE.txt

@@ -1,3 +1,5 @@
+BSD 3-Clause License
+
 Copyright 2025 Aditya Savara
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

{jsongrapher-3.8.dist-info → jsongrapher-4.1.dist-info}/METADATA

@@ -1,10 +1,10 @@
 Metadata-Version: 2.1
 Name: jsongrapher
-Version: 3.8
+Version: 4.1
 Summary: The python version of JSONGrapher with tools for creating JSONGrapher Records.
 Home-page: https://github.com/AdityaSavara/jsongrapher-py
 Author: Aditya Savara
-Author-email: AditySavara2008@u.northwestern.edu
+Author-email: AdityaSavara2008@u.northwestern.edu
 License: BSD-3-Clause
 Classifier: License :: OSI Approved :: BSD License
 Classifier: Programming Language :: Python
@@ -14,7 +14,7 @@ Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Requires-Python: >=3.0.0
 Description-Content-Type: text/markdown
-License-File: LICENSE
+License-File: LICENSE.txt
 Requires-Dist: numpy>=1.26
 Provides-Extra: complete
 Requires-Dist: matplotlib; extra == "complete"
@@ -25,29 +25,31 @@ Requires-Dist: urllib; extra == "complete"
 Requires-Dist: json-equationer; extra == "complete"
 
 
+[![Anaconda-Server Badge](https://anaconda.org/conda-forge/jsongrapher/badges/version.svg)](https://anaconda.org/conda-forge/jsongrapher) [![Anaconda-Server Badge](https://badge.fury.io/py/jsongrapher.svg)](https://badge.fury.io/py/jsongrapher)
+
 # JSONGrapher (python)
-This is the python version of JSONGrapher with JSONRecordCreator. This package is for plotting JSON records with drag and drop and has tools for creating the JSON records.
 
-The software will automatically plot multiple records together, for comparison, and will automaticlaly converting units between records as needed to plot them for comparison (like kg/s and g/s).
+Imagine a world where a person can simply drag a datafile into a graphing utility and a plot will be made, including scientific units, and more plots can be dragged in from data from other sources (and other units) to compare all of the data together, in an interactive graph.
+
+Create interactive plots just by drag-and-drop of JSON records. Share the json files for easy plotting by others. JSONGrapher automatically plots multiple records together, for comparison, and will automaticlaly convert units between records to plot the data sets together. For example, if one record is in kg/s and another in g/s, JSONGrapher will do the conversion automatically to plot both records together for comparison. Tools and examples are included for how to create JSON records.
 
 To use python JSONGrapher, first install it using conda or pip:<br>
 `pip install JSONGrapher[COMPLETE]` or `conda install conda-forge::jsongrapher` <br>
 Alternatively, you can download the directory directly.<br> 
 
 ## **0\. Plotting a JSON Record**
-It's as simple as one line! Then drag an [example](https://github.com/AdityaSavara/jsongrapher-py/tree/main/examples/example_1_drag_and_drop) JSONGrapher record into the window to plot!
-Below shows several plot types for 2D and 3D plots, followed by a simple example of how to use python JSONGrapher to create your own records.
+To create an interactive plot, you just need one line of code! Then drag an [example](https://github.com/AdityaSavara/jsongrapher-py/tree/main/examples/example_1_drag_and_drop) JSONGrapher record into the window to plot!
+Below are example 2D and 3D plots. Further below shows how easy it is to create your own json records.
 <pre>
-import JSONGrapher 
-JSONGrapher.launch()
+import JSONGrapher; JSONGrapher.launch()
 </pre>
 
-[![JSONGRapher window](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/JSONGrapher/JSONGrapherWindowShortened.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/JSONGrapher/JSONGrapherWindowShortened.png) [![JSONGRapher plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/UAN_DTA_image.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/UAN_DTA_image.png)
+[![JSONGRapher window](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/JSONGrapher/JSONGrapherWindowShortened.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/JSONGrapher/JSONGrapherWindowShortened.png) [![JSONGRapher plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/UAN_DTA_image.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/UAN_DTA_image.png)
 
-[![rainbow plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/SrTiO3_rainbow_image.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/SrTiO3_rainbow_image.png)
-[![mesh3d plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/Rate_Constant_mesh3d.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/Rate_Constant_mesh3d.png)
-[![scatter3d plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/Rate_Constant_Scatter3d_example10.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/Rate_Constant_Scatter3d_example10.png)
-[![bubble plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/Rate_Constant_bubble.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/Rate_Constant_bubble.png)
+[![rainbow plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/SrTiO3_rainbow_image.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/SrTiO3_rainbow_image.png)
+[![mesh3d plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_mesh3d.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_mesh3d.png)
+[![scatter3d plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_Scatter3d_example10.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_Scatter3d_example10.png)
+[![bubble plot](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_bubble.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_bubble.png)
 
 
 
@@ -126,3 +128,14 @@ You can also see more examples: https://github.com/AdityaSavara/jsongrapher-py/t
 
 Additionally, json records you send to others can be plotted by them at www.jsongrapher.com
 This 'see the plot using a browser' capability is intended to facilitate including JSONGrapher records in supporting information of scientific publications.
+
+
+## **Contributing to JSONGrapher, Feature Suggestions, and Reporting Issues**
+
+These interactions should be through github at https://github.com/AdityaSavara/jsongrapher-py
+
+To contribute to JSONGrapher, make a pull request with sufficient details about what issue you are trying to solve, and adequate commenting in your code to follow the logic. After that, be prepared for further communication if needed.
+
+To suggest features, create a new issue under the issues tab.
+
+To report issues, create a new issue under the issues tab.

jsongrapher-4.1.dist-info/RECORD

@@ -0,0 +1,19 @@
+JSONGrapher/JSONRecordCreator.py,sha256=46saEYWpy3Oiai2lCAGEfayIs6ZLNBjcH7nC2Yi87G8,214735
+JSONGrapher/UnitPytesting.py,sha256=xizJ-2fg9C5oNMFJyfavbBLMusayE9KWQiYIRrQQd4A,4363
+JSONGrapher/UnitpyCustomUnitsTesting.py,sha256=Rwq5p8HXN0FP54lRFgLTV0kgJ9TpcFaD3_C0MEOoEzw,1297
+JSONGrapher/__init__.py,sha256=fA3R6paWq3uskiLe3OglQZY_uJOejZHMFKdyX0dXWjo,310
+JSONGrapher/drag_and_drop_gui.py,sha256=-7QJHLhzadHotWhONH4inerMaZ_xuwoTQSMRF_MPVe0,5632
+JSONGrapher/equation_creator.py,sha256=VFu6dFo-C0wDf1N3e0CyCBI-53cCUrp3oe0umdMLofs,17968
+JSONGrapher/equation_evaluator.py,sha256=Cm7UK5vWa6fT0OylD9f22_eR8zUvxY_Sy_W6n6N9bew,37012
+JSONGrapher/units_list.py,sha256=ROrlAsD66oPozZmOaE65xjNUEg3CxkSmA8iPE2_ihYI,34438
+JSONGrapher/version.py,sha256=plmUxJqz8GZ6qgO0GmMnNftP7opuGp9bxRvdx2Lbgco,19
+JSONGrapher/styles/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+JSONGrapher/styles/layout_styles_library.py,sha256=vGb1tE_ETY-Blj2frt8ddHA976ADFSCoabjzKn2ZNYU,3051
+JSONGrapher/styles/trace_styles_collection_library.py,sha256=DUbbO8jTlhn2q-lOY1XYGkHV1RbJX-P5Z1SUCM0qo6M,5952
+jsongrapher-4.1.data/data/LICENSE.txt,sha256=7Guw_pmj_H4sApnM7fld2L4HH6CP-3ZYdFoOXtHFx0Y,1489
+jsongrapher-4.1.data/data/README.md,sha256=stbbH5GC2URwaG41OepUSmtH1_2t6CGw-nAxhYy_UJI,7151
+jsongrapher-4.1.dist-info/LICENSE.txt,sha256=7Guw_pmj_H4sApnM7fld2L4HH6CP-3ZYdFoOXtHFx0Y,1489
+jsongrapher-4.1.dist-info/METADATA,sha256=wYThzsgr77C_0dn1oIUN5kmb9C9KKooVlvC0ldbn2Kk,8225
+jsongrapher-4.1.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
+jsongrapher-4.1.dist-info/top_level.txt,sha256=5f7Ui2hCKCPTQOjD540WKghKNYOvUDNfdpnDbIlAD3Y,12
+jsongrapher-4.1.dist-info/RECORD,,

jsongrapher-3.8.dist-info/RECORD

@@ -1,18 +0,0 @@
-JSONGrapher/JSONRecordCreator.py,sha256=SFIYYNDpsUAx6vYA-I2ZGxNw7a1yA3yoIEE6oZtZWfc,205808
-JSONGrapher/UnitPytesting.py,sha256=xizJ-2fg9C5oNMFJyfavbBLMusayE9KWQiYIRrQQd4A,4363
-JSONGrapher/UnitpyCustomUnitsTesting.py,sha256=Rwq5p8HXN0FP54lRFgLTV0kgJ9TpcFaD3_C0MEOoEzw,1297
-JSONGrapher/__init__.py,sha256=cc5qXQidP_ABPXdnXy_DTdgPanHuR7ya45LV-BdWVh8,277
-JSONGrapher/drag_and_drop_gui.py,sha256=-7QJHLhzadHotWhONH4inerMaZ_xuwoTQSMRF_MPVe0,5632
-JSONGrapher/equation_creator.py,sha256=VFu6dFo-C0wDf1N3e0CyCBI-53cCUrp3oe0umdMLofs,17968
-JSONGrapher/equation_evaluator.py,sha256=coNVkZDRmEti3wYOc9NBY2Z1fRz3ei9ZxFd-ST-bOWc,36020
-JSONGrapher/units_list.py,sha256=ROrlAsD66oPozZmOaE65xjNUEg3CxkSmA8iPE2_ihYI,34438
-JSONGrapher/styles/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-JSONGrapher/styles/layout_styles_library.py,sha256=vGb1tE_ETY-Blj2frt8ddHA976ADFSCoabjzKn2ZNYU,3051
-JSONGrapher/styles/trace_styles_collection_library.py,sha256=DUbbO8jTlhn2q-lOY1XYGkHV1RbJX-P5Z1SUCM0qo6M,5952
-jsongrapher-3.8.data/data/LICENSE,sha256=MroL1bQKoAHrMJv2KvABMmZX5j-DZ2EP_zaQacLUtj0,1465
-jsongrapher-3.8.data/data/README.md,sha256=OntfAICB_uwfjoq8tMDYc_W7eXSC2N22X0udPIGb2Nw,5888
-jsongrapher-3.8.dist-info/LICENSE,sha256=MroL1bQKoAHrMJv2KvABMmZX5j-DZ2EP_zaQacLUtj0,1465
-jsongrapher-3.8.dist-info/METADATA,sha256=IZYNGMd9jbDyWIoyqhW1oUan16p04jf228OW4h7wMrk,6959
-jsongrapher-3.8.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-jsongrapher-3.8.dist-info/top_level.txt,sha256=5f7Ui2hCKCPTQOjD540WKghKNYOvUDNfdpnDbIlAD3Y,12
-jsongrapher-3.8.dist-info/RECORD,,