# ProbeCombustor

VTKExamples/Cxx/VisualizationAlgorithms/ProbeCombustor

### Description

Probing obtains dataset attributes by sampling one dataset (the input) with a set of points (the probe). Probing is also called “resampling.” Examples include probing an input dataset with a sequence of points along a line, on a plane, or in a volume. The result of the probing is a new dataset (the output) with the topological and geometric structure of the probe dataset, and point attributes interpolated from the input dataset. Once the probing operation is completed, the output dataset can be visualized with any of the appropriate techniques in VTK.

This example illustrates the details of the probing process. For every point in the probe dataset, the location in the input dataset (i.e., cell, subcell, and parametric coordinates) and interpolation weights are determined. Then the data values from the cell are interpolated to the probe point. Probe points that are outside the input dataset are assigned a nil (or appropriate) value. This process repeats for all points in the probe dataset.

Info

See Figure 9-19 in Chapter 9 The VTK Textbook.

Other Languages

See (Python)

### Code

ProbeCombustor.cxx

    #include <vtkActor.h>
    #include <vtkAppendPolyData.h>
    #include <vtkCamera.h>
    #include <vtkContourFilter.h>
    #include <vtkMultiBlockDataSet.h>
    #include <vtkMultiBlockPLOT3DReader.h>
    #include <vtkNamedColors.h>
    #include <vtkOutlineFilter.h>
    #include <vtkPlaneSource.h>
    #include <vtkPolyDataMapper.h>
    #include <vtkProperty.h>
    #include <vtkProbeFilter.h>
    #include <vtkRenderWindow.h>
    #include <vtkRenderWindowInteractor.h>
    #include <vtkRenderer.h>
    #include <vtkStructuredGrid.h>
    #include <vtkStructuredGridOutlineFilter.h>
    #include <vtkTransform.h>
    #include <vtkTransformPolyDataFilter.h>

    // This shows how to probe a dataset with a plane. The probed data is then
    // contoured.

    int main (int argc, char *argv[])
    {
      if (argc < 3)
      {
        std::cout << "Usage: " << argv[0] << " combxyz.bin combq.bin" << std::endl;
        return EXIT_FAILURE;
      }

      vtkSmartPointer<vtkNamedColors> colors =
        vtkSmartPointer<vtkNamedColors>::New();

    // create pipeline
    //
      vtkSmartPointer<vtkMultiBlockPLOT3DReader> pl3d =
        vtkSmartPointer<vtkMultiBlockPLOT3DReader>::New();
      pl3d->SetXYZFileName(argv[1]);
      pl3d->SetQFileName(argv[2]);
      pl3d->SetScalarFunctionNumber(100);
      pl3d->SetVectorFunctionNumber(202);
      pl3d->Update();

      vtkStructuredGrid *sg =
        vtkStructuredGrid::SafeDownCast(pl3d->GetOutput()->GetBlock(0));

    // We create three planes and position them in the correct position
    // using transform filters. They are then appended together and used as
    // a probe.
      vtkSmartPointer<vtkPlaneSource> plane =
        vtkSmartPointer<vtkPlaneSource>::New();
      plane->SetResolution(50, 50);

      vtkSmartPointer<vtkTransform> transP1 =
        vtkSmartPointer<vtkTransform>::New();
      transP1->Translate(3.7, 0.0, 28.37);
      transP1->Scale(5, 5, 5);
      transP1->RotateY(90);

      vtkSmartPointer<vtkTransformPolyDataFilter> tpd1 =
        vtkSmartPointer<vtkTransformPolyDataFilter>::New();
      tpd1->SetInputConnection(plane->GetOutputPort());
      tpd1->SetTransform(transP1);

      vtkSmartPointer<vtkOutlineFilter> outTpd1 =
        vtkSmartPointer<vtkOutlineFilter>::New();
      outTpd1->SetInputConnection(tpd1->GetOutputPort());

      vtkSmartPointer<vtkPolyDataMapper> mapTpd1 =
        vtkSmartPointer<vtkPolyDataMapper>::New();
      mapTpd1->SetInputConnection(outTpd1->GetOutputPort());

      vtkSmartPointer<vtkActor> tpd1Actor =
        vtkSmartPointer<vtkActor>::New();
      tpd1Actor->SetMapper(mapTpd1);
      tpd1Actor->GetProperty()->SetColor(0, 0, 0);
      tpd1Actor->GetProperty()->SetLineWidth(2.0);

      vtkSmartPointer<vtkTransform> transP2 =
        vtkSmartPointer<vtkTransform>::New();
      transP2->Translate(9.2, 0.0, 31.20);
      transP2->Scale(5, 5, 5);
      transP2->RotateY(90);

      vtkSmartPointer<vtkTransformPolyDataFilter> tpd2 =
        vtkSmartPointer<vtkTransformPolyDataFilter>::New();
      tpd2->SetInputConnection(plane->GetOutputPort());
      tpd2->SetTransform(transP2);

      vtkSmartPointer<vtkOutlineFilter> outTpd2 =
        vtkSmartPointer<vtkOutlineFilter>::New();
      outTpd2->SetInputConnection(tpd2->GetOutputPort());

      vtkSmartPointer<vtkPolyDataMapper> mapTpd2 =
        vtkSmartPointer<vtkPolyDataMapper>::New();
      mapTpd2->SetInputConnection(outTpd2->GetOutputPort());

      vtkSmartPointer<vtkActor> tpd2Actor =
        vtkSmartPointer<vtkActor>::New();
      tpd2Actor->SetMapper(mapTpd2);
      tpd2Actor->GetProperty()->SetColor(0, 0, 0);
      tpd2Actor->GetProperty()->SetLineWidth(2.0);

      vtkSmartPointer<vtkTransform> transP3 =
        vtkSmartPointer<vtkTransform>::New();
      transP3->Translate(13.27, 0.0, 33.30);
      transP3->Scale(5, 5, 5);
      transP3->RotateY(90);

      vtkSmartPointer<vtkTransformPolyDataFilter> tpd3 =
        vtkSmartPointer<vtkTransformPolyDataFilter>::New();
      tpd3->SetInputConnection(plane->GetOutputPort());
      tpd3->SetTransform(transP3);

      vtkSmartPointer<vtkOutlineFilter> outTpd3 =
        vtkSmartPointer<vtkOutlineFilter>::New();
      outTpd3->SetInputConnection(tpd3->GetOutputPort());

      vtkSmartPointer<vtkPolyDataMapper> mapTpd3 =
        vtkSmartPointer<vtkPolyDataMapper>::New();
      mapTpd3->SetInputConnection(outTpd3->GetOutputPort());

      vtkSmartPointer<vtkActor> tpd3Actor =
        vtkSmartPointer<vtkActor>::New();
      tpd3Actor->SetMapper(mapTpd3);
      tpd3Actor->GetProperty()->SetColor(0, 0, 0);
      tpd3Actor->GetProperty()->SetLineWidth(2.0);

      vtkSmartPointer<vtkAppendPolyData> appendF =
        vtkSmartPointer<vtkAppendPolyData>::New();
      appendF->AddInputConnection(tpd1->GetOutputPort());
      appendF->AddInputConnection(tpd2->GetOutputPort());
      appendF->AddInputConnection(tpd3->GetOutputPort());

    // The vtkProbeFilter takes two inputs. One is a dataset to use as the probe
    // geometry (SetInputConnection); the other is the data to probe
    // (SetSourceConnection). The output dataset structure (geometry and
    // topology) of the probe is the same as the structure of the input. The
    // probing process generates new data values resampled from the source.
      vtkSmartPointer<vtkProbeFilter> probe =
        vtkSmartPointer<vtkProbeFilter>::New();
      probe->SetInputConnection(appendF->GetOutputPort());
      probe->SetSourceData(sg);

      vtkSmartPointer<vtkContourFilter> contour =
        vtkSmartPointer<vtkContourFilter>::New();
      contour->SetInputConnection(probe->GetOutputPort());
      contour->GenerateValues(50, sg->GetScalarRange());

      vtkSmartPointer<vtkPolyDataMapper> contourMapper =
        vtkSmartPointer<vtkPolyDataMapper>::New();
      contourMapper->SetInputConnection(contour->GetOutputPort());
      contourMapper->SetScalarRange(sg->GetScalarRange());

      vtkSmartPointer<vtkActor> planeActor =
        vtkSmartPointer<vtkActor>::New();
      planeActor->SetMapper(contourMapper);

      vtkSmartPointer<vtkStructuredGridOutlineFilter> outline =
        vtkSmartPointer<vtkStructuredGridOutlineFilter>::New();
      outline->SetInputData(sg);

      vtkSmartPointer<vtkPolyDataMapper> outlineMapper =
        vtkSmartPointer<vtkPolyDataMapper>::New();
      outlineMapper->SetInputConnection(outline->GetOutputPort());

      vtkSmartPointer<vtkActor> outlineActor =
        vtkSmartPointer<vtkActor>::New();
      outlineActor->SetMapper(outlineMapper);
      outlineActor->GetProperty()->SetColor(0, 0, 0);
      outlineActor->GetProperty()->SetLineWidth(2.0);

    // Create the RenderWindow, Renderer and both Actors
    //
      vtkSmartPointer<vtkRenderer> ren1 =
        vtkSmartPointer<vtkRenderer>::New();

      vtkSmartPointer<vtkRenderWindow> renWin =
        vtkSmartPointer<vtkRenderWindow>::New();
      renWin->AddRenderer(ren1);

      vtkSmartPointer<vtkRenderWindowInteractor> iren =
        vtkSmartPointer<vtkRenderWindowInteractor>::New();
      iren->SetRenderWindow(renWin);

      ren1->AddActor(outlineActor);
      ren1->AddActor(planeActor);
      ren1->AddActor(tpd1Actor);
      ren1->AddActor(tpd2Actor);
      ren1->AddActor(tpd3Actor);
      ren1->SetBackground(colors->GetColor3d("Gainsboro").GetData());
      renWin->SetSize(640, 480);

      ren1->ResetCamera();
      ren1->GetActiveCamera()->SetClippingRange(3.95297, 50);
      ren1->GetActiveCamera()->SetFocalPoint(8.88908, 0.595038, 29.3342);
      ren1->GetActiveCamera()->SetPosition(-12.3332, 31.7479, 41.2387);
      ren1->GetActiveCamera()->SetViewUp(0.060772, -0.319905, 0.945498);

      renWin->Render();
      iren->Start();

      return EXIT_SUCCESS;
    }

### CMakeLists.txt

    cmake_minimum_required(VERSION 3.3 FATAL_ERROR)

    project(ProbeCombustor)

    find_package(VTK COMPONENTS
      vtkCommonColor
      vtkCommonDataModel
      vtkCommonTransforms
      vtkFiltersCore
      vtkFiltersGeneral
      vtkFiltersModeling
      vtkFiltersSources
      vtkIOParallel
      vtkInteractionStyle
      vtkRenderingCore
      vtkRenderingFreeType
      vtkRenderingOpenGL2 QUIET)
    if (NOT VTK_FOUND)
      message("Skipping ProbeCombustor: ${VTK_NOT_FOUND_MESSAGE}")
      return ()
    endif()
    message (STATUS "VTK_VERSION: ${VTK_VERSION}")
    if (VTK_VERSION VERSION_LESS "8.90.0")
      # old system
      include(${VTK_USE_FILE})
      add_executable(ProbeCombustor MACOSX_BUNDLE ProbeCombustor.cxx )
      target_link_libraries(ProbeCombustor PRIVATE ${VTK_LIBRARIES})
    else ()
      # include all components
      add_executable(ProbeCombustor MACOSX_BUNDLE ProbeCombustor.cxx )
      target_link_libraries(ProbeCombustor PRIVATE ${VTK_LIBRARIES})
      # vtk_module_autoinit is needed
      vtk_module_autoinit(
        TARGETS ProbeCombustor
        MODULES ${VTK_LIBRARIES}
        )
    endif ()

### Download and Build ProbeCombustor

Click here to download ProbeCombustor and its CMakeLists.txt file. Once the tarball ProbeCombustor.tar has been downloaded and extracted,

    cd ProbeCombustor/build

If VTK is installed:

    cmake ..

If VTK is not installed but compiled on your system, you will need to specify the path to your VTK build:

    cmake -DVTK_DIR:PATH=/home/me/vtk_build ..

Build the project:

    make

and run it:

    ./ProbeCombustor

WINDOWS USERS

Be sure to add the VTK bin directory to your path. This will resolve the VTK dll's at run time.