SaC kernel plotting visualisations

Python/Python.sac

@@ -0,0 +1,89 @@
+module Python;
+
+provide all;
+export all;
+
+use StdIO: all;
+use Array: all;
+
+/* 
+ *  Module to print sac arrays in python format.  
+ *  Works for all SaC datatypes.
+ */
+
+
+void pyPrint(byte[*] a) { pyPrint(toll(a)); }
+void pyPrint(short[*] a) { pyPrint(toll(a)); }
+void pyPrint(int[*] a) { pyPrint(toll(a)); }
+void pyPrint(long[*] a) { pyPrint(toll(a)); }
+
+void pyPrint(ubyte[*] a) { pyPrint(toull(a)); }
+void pyPrint(ushort[*] a) { pyPrint(toull(a)); }
+void pyPrint(uint[*] a) { pyPrint(toull(a)); }
+void pyPrint(ulong[*] a) { pyPrint(toull(a)); }
+
+void pyPrint(float[*] a) { pyPrint(tod(a)); }
+
+
+void pyPrint (longlong[*] a){
+    StdIO::printf ("[");
+
+    for(i=0; i< shape(a)[0]; i++) {
+       pyPrint (a[i]);
+       if (i<shape(a)[0]-1)
+          StdIO::printf(", ");
+
+    }
+    StdIO::printf ("]");
+}
+void pyPrint (longlong a){
+   StdIO::printf ("%d ", a);
+}
+
+
+void pyPrint (ulonglong[*] a){
+    StdIO::printf ("[");
+
+    for(i=0; i< shape(a)[0]; i++) {
+       pyPrint (a[i]);
+       if (i<shape(a)[0]-1)
+          StdIO::printf(", ");
+
+    }
+    StdIO::printf ("]");
+}
+void pyPrint (ulonglong a){
+   StdIO::printf ("%d ", a);
+}
+
+
+void pyPrint (double[*] a){
+    StdIO::printf ("[");
+
+    for( i=0; i< shape(a)[0]; i++) {
+       pyPrint (a[i]);
+       if (i<shape(a)[0]-1)
+          StdIO::printf(", ");
+
+    }
+    StdIO::printf ("]");
+}
+void pyPrint (double a){
+   StdIO::printf ("%f ", a);
+}
+
+
+void pyPrint (char[*] a){
+    StdIO::printf ("[");
+
+    for(i=0; i< shape(a)[0]; i++) {
+       pyPrint (a[i]);
+       if (i<shape(a)[0]-1)
+          StdIO::printf(", ");
+
+    }
+    StdIO::printf ("]");
+}
+void pyPrint (char a){
+   StdIO::printf ("%s ", a);
+}

Python/sac2crc.python

@@ -0,0 +1,7 @@
+target Python:
+
+TREE_OUTPUTDIR += ":/home/.../Python"
+LIB_OUTPUTDIR  += ":/home/.../Python"
+LIBS           += " "
+
+target package :: Python:

README.md

@@ -44,6 +44,10 @@ Running sac kernel is as simple as:
 ```bash
 jupyter notebook
 ```
+or
+```bash
+jupyter-lab
+```
 and in the web interface you set the kernel language to SaC.
 
 On the terminal you can run:
@@ -53,3 +57,17 @@ ipython console --kernel=sac
 If you do so you may want to install this lexer https://github.com/SacBase/sac-pygments
 to get syntax highlighting.
 
+## Additional installations
+The following module and plotting library need to be installed to be able to use the `%plot` command inside of Jupyter that (as the name suggests) can plot SaC variables inside the notebook. The kernel will still be usable without these additions and is only needed for the plotting feature.
+
+- The [matplotlib](https://matplotlib.org/stable/) python library should be installed on your system for the plots to work. This can be done using the `pip` or third party `conda` library using
+```bash
+pip install matplotlib
+```
+or
+```bash
+conda install matplotlib
+```
+
+- The SaC `Python` module present in this repository is also needed for the plot function to work. It needs to be recognised by the SaC library. To do so create a folder called `.sac2crc` in your home directory and paste the file called `sac2crc.python` (found in the Python folder in this repository) into it. The SaC compiler will look for this folder. Edit line 3 and 4 in this file, making them both hold the path to where the `Python` folder is located on your device. Now only the `use Python: all;` statement is needed in the notebook to start plotting.
+