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

JSONGrapher/JSONRecordCreator.py

@@ -755,12 +755,13 @@ class JSONGrapherRecord:
         self.fig_dict["data"].append(data_series_dict) #implied return.
         return data_series_dict
 
-    def add_data_series_as_equation(self, series_name, x_values=None, y_values=None, equation_dict=None, evaluate_equations_as_added=True, comments="", trace_style="", uid="", line="", extra_fields=None):
+    def add_data_series_as_equation(self, series_name, graphical_dimensionality, x_values=None, y_values=None, equation_dict=None, evaluate_equations_as_added=True, comments="", trace_style="", uid="", line="", extra_fields=None):
         """
         This is a way to add an equation that would be used to fill an x,y data series.
         The equation will be a equation_dict of the json_equationer type
         """
         # series_name: Name of the data series.
+        # graphical_dimensionality is the number of geometric dimensions, so should be either 2 or 3.
         # x: List of x-axis values. Or similar structure.
         # y: List of y-axis values. Or similar structure.
         # equation_dict: This is the field for the equation_dict of json_equationer type
@@ -777,6 +778,7 @@ class JSONGrapherRecord:
             y_values = []
         if equation_dict is None:
             equation_dict = {}
+        equation_dict["graphical_dimensionality"] = int(graphical_dimensionality)
 
         x_values = list(x_values)
         y_values = list(y_values)
@@ -1938,6 +1940,7 @@ def apply_plot_style_to_plotly_dict(fig_dict, plot_style=None):
     if str(plot_style["layout_style"]).lower() != 'none': #take no action if received "None" or NoneType
         if plot_style["layout_style"] == '': #in this case, we're going to use the default.
             plot_style["layout_style"] = 'default'
+            print("Warning: No layout_style provided and 'z' field found in first data series. For 'bubble' plots, it is recommended to set layout_style to 'default'. For 'mesh3d' graphs and 'scatter3d' graphs, it is recommended to set layout_style to 'default3d'. Set layout_style to 'none' or another layout_style to avoid this warning.")
         fig_dict = remove_layout_style_from_plotly_dict(fig_dict=fig_dict)
         fig_dict = apply_layout_style_to_plotly_dict(fig_dict=fig_dict, layout_style_to_apply=plot_style["layout_style"])
     #Code logic for trace_styles_collection style.
@@ -3485,11 +3488,11 @@ def evaluate_equation_for_data_series_by_index(fig_dict, data_series_index, verb
         data_dict_filled['equation'] = equation_dict_evaluated
         data_dict_filled['x_label'] = data_dict_filled['equation']['x_variable'] 
         data_dict_filled['y_label'] = data_dict_filled['equation']['y_variable'] 
-        data_dict_filled['x'] = equation_dict_evaluated['x_points']
-        data_dict_filled['y'] = equation_dict_evaluated['y_points']
+        data_dict_filled['x'] = list(equation_dict_evaluated['x_points'])
+        data_dict_filled['y'] = list(equation_dict_evaluated['y_points'])
         if graphical_dimensionality == 3:
             data_dict_filled['z_label'] = data_dict_filled['equation']['z_variable'] 
-            data_dict_filled['z'] = equation_dict_evaluated['z_points']
+            data_dict_filled['z'] = list(equation_dict_evaluated['z_points'])
         #data_dict_filled may include "x_label" and/or "y_label". If it does, we'll need to check about scaling units.
         if (("x_label" in data_dict_filled) or ("y_label" in data_dict_filled)) or ("z_label" in data_dict_filled):
             #first, get the units that are in the layout of fig_dict so we know what to convert to.
@@ -3558,10 +3561,10 @@ def update_implicit_data_series_data(target_fig_dict, source_fig_dict, parallel_
         # Use zip() when parallel_structure=True and lengths match
         for target_series, source_series in zip(target_data_series, source_data_series):
             if ("equation" in target_series) or ("simulate" in target_series):
-                target_series["x"] = source_series.get("x", [])  # Extract and apply "x" values
-                target_series["y"] = source_series.get("y", [])  # Extract and apply "y" values
+                target_series["x"] = list(source_series.get("x", []))  # Extract and apply "x" values
+                target_series["y"] = list(source_series.get("y", []))  # Extract and apply "y" values
                 if "z" in source_series:
-                    target_series["z"] = source_series.get("z", [])  # Extract and apply "z" values                    
+                    target_series["z"] = list(source_series.get("z", []))  # Extract and apply "z" values                    
     else:
         # Match by name when parallel_structure=False or lengths differ
         source_data_dict = {series["name"]: series for series in source_data_series if "name" in series}
@@ -3572,10 +3575,10 @@ def update_implicit_data_series_data(target_fig_dict, source_fig_dict, parallel_
                
                 if target_name in source_data_dict:
                     source_series = source_data_dict[target_name]
-                    target_series["x"] = source_series.get("x", [])  # Extract and apply "x" values
-                    target_series["y"] = source_series.get("y", [])  # Extract and apply "y" values
+                    target_series["x"] = list(source_series.get("x", []))  # Extract and apply "x" values
+                    target_series["y"] = list(source_series.get("y", []))  # Extract and apply "y" values
                     if "z" in source_series:
-                        target_series["z"] = source_series.get("z", [])  # Extract and apply "z" values                    
+                        target_series["z"] = list(source_series.get("z", []))  # Extract and apply "z" values                    
     return updated_fig_dict
 
 

JSONGrapher/version.py

@@ -1 +1 @@
-__version__ = '4.1'
+__version__ = '4.2'

jsongrapher-4.2.data/data/README.md

@@ -0,0 +1,118 @@
+[![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)
+
+Imagine a world where a person can simply drag a data file into a graphing utility and a plot will be made -- including axes with the data's units. Imagine that data from data other sources (with other units) can then be dragged in for comparison, with all data plotted on an interactive graph. Imagine that the units of all of these datasets will be converted automatically, as needed, during the plotting.
+
+Create interactive plots just by drag-and-drop of JSON records. Share the json files for easy plotting by others. JSONGrapher will automatically convert units between records to plot the data sets together, to enable comparisons. 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**
+To create an interactive plot, you just need one line of code! <br>
+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. <br>
+Further below shows how easy it is to create your own json records.
+<pre>
+import JSONGrapher; JSONGrapher.launch()
+# Then just drag records into the window!
+</pre>
+
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/JSONGrapherWindowShortened.gif"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/JSONGrapherWindowShortened.gif" width="20%"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/UAN_DTA_image.gif"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/UAN_DTA_image.gif" width="25%"></a>
+<br>
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_mesh3d.gif"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_mesh3d.gif" width="35%"></a>
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_Scatter3d_example10.gif"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_Scatter3d_example10.gif" width="35%"></a>
+<br>
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_bubble.gif"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_bubble.gif" width="35%"></a>&nbsp;&nbsp;&nbsp;
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/SrTiO3_rainbow_image.gif"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/SrTiO3_rainbow_image.gif" width="30%"></a>
+<br><br>
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/O_OH_Scaling.gif"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/O_OH_Scaling.gif" width="50%"></a>
+
+
+## **1\. Preparing to Create a Record**
+
+The remainder of this landing page follows a json record tutorial [example file](https://github.com/AdityaSavara/jsongrapher-py/blob/main/examples/example_2_creating_records_and_using_styles/example_2_json_record_tutorial.py) which shows how to create graphable .json records. The records can then be plotted with python JSONGrapher or with jsongrapher.com<br>
+
+Let's create an example where we plot the height of a pear tree over several years. 
+<pre>
+Record = JSONRecordCreator.create_new_JSONGrapherRecord()
+x_label_including_units = "Time (years)"
+y_label_including_units = "Height (m)"
+time_in_years = [0, 1, 2, 3, 4]
+tree_heights = [0, 0.42, 0.86, 1.19, 1.45]
+</pre>
+
+## **2\. Populating the New JSONGrapher Record**
+
+<pre>
+Record.set_comments("Tree Growth Data collected from the US National Arboretum")
+Record.set_datatype("Tree_Growth_Curve")
+Record.set_x_axis_label_including_units(x_label_including_units)
+Record.set_y_axis_label_including_units(y_label_including_units)
+Record.add_data_series(series_name="pear tree growth", x_values=time_in_years, y_values=tree_heights, plot_type="scatter_spline")
+Record.set_graph_title("Pear Tree Growth Versus Time")
+</pre>
+
+## **3\. Exporting to File**
+
+We can export a record to a .json file, which can then be used with JSONGrapher. 
+<pre>
+Record.export_to_json_file("ExampleFromTutorial.json")
+Record.print_to_inspect()
+</pre>
+
+<p><strong>Expected Output:</strong></p>
+<pre>
+JSONGrapher Record exported to, ./ExampleFromTutorial.json
+{
+    "comments": "Tree Growth Data collected from the US National Arboretum",
+    "datatype": "Tree_Growth_Curve",
+    "data": [
+        {
+            "name": "pear tree growth",
+            "x": [0, 1, 2, 3, 4],
+            "y": [0, 0.42, 0.86, 1.19, 1.45],
+            "type": "scatter",
+            "line": { "shape": "spline" }
+        }
+    ],
+    "layout": {
+        "title": "Pear Tree Growth Versus Time",
+        "xaxis": { "title": "Time (year)" },
+        "yaxis": { "title": "Height (m)" }
+    }
+}
+</pre>
+
+## **4\. Plotting to Inspect**
+
+We can plot the data with plotly, interact with the graph, and save as a png file.
+<pre>
+Record.plot_with_plotly() #Try hovering your mouse over points after this command!
+</pre>
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_2_creating_records_and_using_styles/image_from_tutorial_plotly_fig.png"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_2_creating_records_and_using_styles/image_from_tutorial_plotly_fig.png" width="40%"></a>
+
+We can plot the data using Matplotlib and export the plot as a PNG file.
+<pre>
+Record.plot_with_matplotlib()
+Record.export_to_matplotlib_png("image_from_tutorial_matplotlib_fig")
+</pre>
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_2_creating_records_and_using_styles/image_from_tutorial_matplotlib_fig.png"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_2_creating_records_and_using_styles/image_from_tutorial_matplotlib_fig.png" width="40%"></a>
+
+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.
+
+
+## **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 → jsongrapher-4.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: jsongrapher
-Version: 4.1
+Version: 4.2
 Summary: The python version of JSONGrapher with tools for creating JSONGrapher Records.
 Home-page: https://github.com/AdityaSavara/jsongrapher-py
 Author: Aditya Savara
@@ -29,29 +29,33 @@ Requires-Dist: json-equationer; extra == "complete"
 
 # JSONGrapher (python)
 
-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.
+Imagine a world where a person can simply drag a data file into a graphing utility and a plot will be made -- including axes with the data's units. Imagine that data from data other sources (with other units) can then be dragged in for comparison, with all data plotted on an interactive graph. Imagine that the units of all of these datasets will be converted automatically, as needed, during the plotting.
 
-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.
+Create interactive plots just by drag-and-drop of JSON records. Share the json files for easy plotting by others. JSONGrapher will automatically convert units between records to plot the data sets together, to enable comparisons. 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**
-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.
+To create an interactive plot, you just need one line of code! <br>
+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. <br>
+Further below shows how easy it is to create your own json records.
 <pre>
 import JSONGrapher; JSONGrapher.launch()
+# Then just drag records into the window!
 </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/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/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)
-
-
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/JSONGrapherWindowShortened.gif"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/JSONGrapherWindowShortened.gif" width="20%"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/UAN_DTA_image.gif"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/UAN_DTA_image.gif" width="25%"></a>
+<br>
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_mesh3d.gif"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_mesh3d.gif" width="35%"></a>
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_Scatter3d_example10.gif"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_Scatter3d_example10.gif" width="35%"></a>
+<br>
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_bubble.gif"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/Rate_Constant_bubble.gif" width="35%"></a>&nbsp;&nbsp;&nbsp;
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/SrTiO3_rainbow_image.gif"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/SrTiO3_rainbow_image.gif" width="30%"></a>
+<br><br>
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/O_OH_Scaling.gif"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_1_drag_and_drop/images/O_OH_Scaling.gif" width="50%"></a>
 
 
 ## **1\. Preparing to Create a Record**
@@ -60,16 +64,16 @@ The remainder of this landing page follows a json record tutorial [example file]
 
 Let's create an example where we plot the height of a pear tree over several years. 
 <pre>
+Record = JSONRecordCreator.create_new_JSONGrapherRecord()
 x_label_including_units = "Time (years)"
 y_label_including_units = "Height (m)"
 time_in_years = [0, 1, 2, 3, 4]
 tree_heights = [0, 0.42, 0.86, 1.19, 1.45]
 </pre>
 
-## **2\. Creating and Populating a New JSONGrapher Record**
+## **2\. Populating the New JSONGrapher Record**
 
 <pre>
-Record = JSONRecordCreator.create_new_JSONGrapherRecord()
 Record.set_comments("Tree Growth Data collected from the US National Arboretum")
 Record.set_datatype("Tree_Growth_Curve")
 Record.set_x_axis_label_including_units(x_label_including_units)
@@ -111,18 +115,18 @@ JSONGrapher Record exported to, ./ExampleFromTutorial.json
 
 ## **4\. Plotting to Inspect**
 
-We can plot the data using Matplotlib and export the plot as a PNG file.
+We can plot the data with plotly, interact with the graph, and save as a png file.
 <pre>
-Record.plot_with_matplotlib()
-Record.export_to_matplotlib_png("image_from_tutorial_matplotlib_fig")
+Record.plot_with_plotly() #Try hovering your mouse over points after this command!
 </pre>
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_2_creating_records_and_using_styles/image_from_tutorial_plotly_fig.png"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_2_creating_records_and_using_styles/image_from_tutorial_plotly_fig.png" width="40%"></a>
 
-We can create an interactive graph with python plotly:
+We can plot the data using Matplotlib and export the plot as a PNG file.
 <pre>
-Record.plot_with_plotly() #Try hovering your mouse over points after this command!
+Record.plot_with_matplotlib()
+Record.export_to_matplotlib_png("image_from_tutorial_matplotlib_fig")
 </pre>
-
-[![JSONGRapher record plotted using matplotlib](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_2_creating_records_and_using_styles/image_from_tutorial_matplotlib_fig.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_2_creating_records_and_using_styles/image_from_tutorial_matplotlib_fig.png)
+<a href="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_2_creating_records_and_using_styles/image_from_tutorial_matplotlib_fig.png"><img src="https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_2_creating_records_and_using_styles/image_from_tutorial_matplotlib_fig.png" width="40%"></a>
 
 You can also see more examples: https://github.com/AdityaSavara/jsongrapher-py/tree/main/examples
 

{jsongrapher-4.1.dist-info → jsongrapher-4.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-JSONGrapher/JSONRecordCreator.py,sha256=46saEYWpy3Oiai2lCAGEfayIs6ZLNBjcH7nC2Yi87G8,214735
+JSONGrapher/JSONRecordCreator.py,sha256=Wu5gCafri9g4bAAcyAJwlAoTLkExx7ssxjnQYcuGPUg,215343
 JSONGrapher/UnitPytesting.py,sha256=xizJ-2fg9C5oNMFJyfavbBLMusayE9KWQiYIRrQQd4A,4363
 JSONGrapher/UnitpyCustomUnitsTesting.py,sha256=Rwq5p8HXN0FP54lRFgLTV0kgJ9TpcFaD3_C0MEOoEzw,1297
 JSONGrapher/__init__.py,sha256=fA3R6paWq3uskiLe3OglQZY_uJOejZHMFKdyX0dXWjo,310
@@ -6,14 +6,14 @@ JSONGrapher/drag_and_drop_gui.py,sha256=-7QJHLhzadHotWhONH4inerMaZ_xuwoTQSMRF_MP
 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/version.py,sha256=bUff73G-qXNfPT8kDpDG9cWR4Adm49E9fp682pqJfbI,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-4.2.data/data/LICENSE.txt,sha256=7Guw_pmj_H4sApnM7fld2L4HH6CP-3ZYdFoOXtHFx0Y,1489
+jsongrapher-4.2.data/data/README.md,sha256=u9uRPF0T12Pl6M6qjEleXZoB41ye0VTQPCJpEdldwNU,8157
+jsongrapher-4.2.dist-info/LICENSE.txt,sha256=7Guw_pmj_H4sApnM7fld2L4HH6CP-3ZYdFoOXtHFx0Y,1489
+jsongrapher-4.2.dist-info/METADATA,sha256=SmJRCR_Mh6cYNpdGZnB1AsA8C-k-iBD8Cvd_PcFojCo,9231
+jsongrapher-4.2.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
+jsongrapher-4.2.dist-info/top_level.txt,sha256=5f7Ui2hCKCPTQOjD540WKghKNYOvUDNfdpnDbIlAD3Y,12
+jsongrapher-4.2.dist-info/RECORD,,

jsongrapher-4.1.data/data/README.md

@@ -1,114 +0,0 @@
-[![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)
-
-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**
-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()
-</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/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/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)
-
-
-
-
-## **1\. Preparing to Create a Record**
-
-The remainder of this landing page follows a json record tutorial [example file](https://github.com/AdityaSavara/jsongrapher-py/blob/main/examples/example_2_creating_records_and_using_styles/example_2_json_record_tutorial.py) which shows how to create graphable .json records. The records can then be plotted with python JSONGrapher or with jsongrapher.com<br>
-
-Let's create an example where we plot the height of a pear tree over several years. 
-<pre>
-x_label_including_units = "Time (years)"
-y_label_including_units = "Height (m)"
-time_in_years = [0, 1, 2, 3, 4]
-tree_heights = [0, 0.42, 0.86, 1.19, 1.45]
-</pre>
-
-## **2\. Creating and Populating a New JSONGrapher Record**
-
-<pre>
-Record = JSONRecordCreator.create_new_JSONGrapherRecord()
-Record.set_comments("Tree Growth Data collected from the US National Arboretum")
-Record.set_datatype("Tree_Growth_Curve")
-Record.set_x_axis_label_including_units(x_label_including_units)
-Record.set_y_axis_label_including_units(y_label_including_units)
-Record.add_data_series(series_name="pear tree growth", x_values=time_in_years, y_values=tree_heights, plot_type="scatter_spline")
-Record.set_graph_title("Pear Tree Growth Versus Time")
-</pre>
-
-## **3\. Exporting to File**
-
-We can export a record to a .json file, which can then be used with JSONGrapher. 
-<pre>
-Record.export_to_json_file("ExampleFromTutorial.json")
-Record.print_to_inspect()
-</pre>
-
-<p><strong>Expected Output:</strong></p>
-<pre>
-JSONGrapher Record exported to, ./ExampleFromTutorial.json
-{
-    "comments": "Tree Growth Data collected from the US National Arboretum",
-    "datatype": "Tree_Growth_Curve",
-    "data": [
-        {
-            "name": "pear tree growth",
-            "x": [0, 1, 2, 3, 4],
-            "y": [0, 0.42, 0.86, 1.19, 1.45],
-            "type": "scatter",
-            "line": { "shape": "spline" }
-        }
-    ],
-    "layout": {
-        "title": "Pear Tree Growth Versus Time",
-        "xaxis": { "title": "Time (year)" },
-        "yaxis": { "title": "Height (m)" }
-    }
-}
-</pre>
-
-## **4\. Plotting to Inspect**
-
-We can plot the data using Matplotlib and export the plot as a PNG file.
-<pre>
-Record.plot_with_matplotlib()
-Record.export_to_matplotlib_png("image_from_tutorial_matplotlib_fig")
-</pre>
-
-We can create an interactive graph with python plotly:
-<pre>
-Record.plot_with_plotly() #Try hovering your mouse over points after this command!
-</pre>
-
-[![JSONGRapher record plotted using matplotlib](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_2_creating_records_and_using_styles/image_from_tutorial_matplotlib_fig.png)](https://raw.githubusercontent.com/AdityaSavara/JSONGrapher-py/main/examples/example_2_creating_records_and_using_styles/image_from_tutorial_matplotlib_fig.png)
-
-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.
-
-
-## **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.