Add VolumeMesher and VOLUME_MESH task type

ability to read unstructured data from legacy vtk format

Adding a plot_mesh method for heat charge and mesher data

Adding more tests and docstrings, and validate VolumeMeshMonitor at least 2D

New unstructured mesh section in API docs

Author: momchil-flex

docs/api/charge/discretization.rst

@@ -26,25 +26,3 @@ Monitor Data
    tidy3d.SteadyFreeCarrierData
    tidy3d.SteadyCapacitanceData
 
-
-Unstructured Data Classes
-^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autosummary::
-   :toctree: ../_autosummary/
-   :template: module.rst
-
-   tidy3d.TriangularGridDataset
-   tidy3d.TetrahedralGridDataset
-
-
-Individual Datasets
-^^^^^^^^^^^^^^^^^^^
-
-.. autosummary::
-   :toctree: ../_autosummary/
-   :template: module.rst
-
-   tidy3d.PointDataArray
-   tidy3d.CellDataArray
-   tidy3d.IndexedDataArray

docs/api/charge/output_data.rst

@@ -23,26 +23,3 @@ Monitor Data
    :template: module.rst
 
    tidy3d.TemperatureData
-
-
-Unstructured Data Classes
-^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autosummary::
-   :toctree: ../_autosummary/
-   :template: module.rst
-
-   tidy3d.TriangularGridDataset
-   tidy3d.TetrahedralGridDataset
-
-
-Individual Datasets
-^^^^^^^^^^^^^^^^^^^
-
-.. autosummary::
-   :toctree: ../_autosummary/
-   :template: module.rst
-
-   tidy3d.PointDataArray
-   tidy3d.CellDataArray
-   tidy3d.IndexedDataArray

docs/api/heat/output_data.rst

@@ -24,6 +24,7 @@ API |:computer:|
     scene
     logging
     submit_simulations
+    mesh/index
     heat/index
     charge/index
     eme/index
@@ -52,6 +53,7 @@ API |:computer:|
 .. include:: /api/scene.rst
 .. include:: /api/logging.rst
 .. include:: /api/submit_simulations.rst
+.. include:: /api/mesh/index.rst
 .. include:: /api/heat/index.rst
 .. include:: /api/charge/index.rst
 .. include:: /api/eme/index.rst

docs/api/index.rst

@@ -0,0 +1,15 @@
+Unstructured mesh |:spider_web:|
+=================================
+
+.. toctree::
+    :hidden:
+
+    discretization
+    mesher
+    monitor
+    output_data
+
+.. include:: /api/mesh/discretization.rst
+.. include:: /api/mesh/mesher.rst
+.. include:: /api/mesh/monitor.rst
+.. include:: /api/mesh/output_data.rst

docs/api/heat/discretization.rst renamed to docs/api/mesh/discretization.rst

@@ -0,0 +1,10 @@
+.. currentmodule:: tidy3d
+
+Volume mesher
+--------------
+
+.. autosummary::
+   :toctree: ../_autosummary/
+   :template: module.rst
+
+   tidy3d.VolumeMesher

docs/api/mesh/index.rst

@@ -0,0 +1,10 @@
+.. currentmodule:: tidy3d
+
+Mesh monitors
+--------------
+
+.. autosummary::
+   :toctree: ../_autosummary/
+   :template: module.rst
+
+   tidy3d.VolumeMeshMonitor

docs/api/mesh/mesher.rst

@@ -0,0 +1,47 @@
+.. currentmodule:: tidy3d
+
+Output Data
+-------------
+
+
+Simulation Data
+^^^^^^^^^^^^^^^^^^^^
+
+.. autosummary::
+   :toctree: ../_autosummary/
+   :template: module.rst
+
+   tidy3d.VolumeMesherData
+
+
+Monitor Data
+^^^^^^^^^^^^
+
+.. autosummary::
+   :toctree: ../_autosummary/
+   :template: module.rst
+
+   tidy3d.VolumeMeshData
+
+
+Unstructured Data Classes
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autosummary::
+   :toctree: ../_autosummary/
+   :template: module.rst
+
+   tidy3d.TriangularGridDataset
+   tidy3d.TetrahedralGridDataset
+
+
+Individual Datasets
+^^^^^^^^^^^^^^^^^^^
+
+.. autosummary::
+   :toctree: ../_autosummary/
+   :template: module.rst
+
+   tidy3d.PointDataArray
+   tidy3d.CellDataArray
+   tidy3d.IndexedDataArray