GetHyperCubeBinnedDataAsync Method

Overloads

GetHyperCubeBinnedDataAsync(String, IEnumerable<NxPage>, NxViewPort, IEnumerable<NxDataAreaPage>, Int32, Int32, Int32)

This method supports data binning.

When a generic object with two or three measures and one dimension contains a lot of data, groups of points (for example, cells) can be rendered instead of points.

A zone of interest can be refined (for zooming in) up to a maximum refinement level (set in the qQueryLevel parameter) or coarsened (for zoom out).

The grid of cells is adaptive (not static), meaning that it adapts to different length scales.

The GetHyperCubeBinnedData method gives information about the adaptive grid and the values of the generic object.

The number of points in a cell and the coordinates (expressed in the measure range) of each cell are returned.

Dimension values and measure values are rendered at point level (highest detailed level).

Adaptive Grid

More details about the properties of the adaptive grid are given in this paragraph.

When the refinement is not the highest (cells are rendered), information about the adaptive grid is returned through several arrays.

The first array contains the following properties:

Please refer to Engine API reference for table definition.

The next arrays give the coordinates of each cell in the page.

Each array contains the following properties:

Please refer to Engine API reference for table definition.

Dimension values and measures values

More details about the properties, when dimension and measure values are returned, are given in this paragraph.

When the refinement is high, points are rendered (not cells) and dimension and measure values for each cell are returned.

The first array is empty because no information on the adaptive grid is needed.

The next arrays bring information about the dimension and the measure values.

Please refer to Engine API reference for table definition.

GetHyperCubeBinnedDataAsync(AsyncHandle, String, IEnumerable<NxPage>, NxViewPort, IEnumerable<NxDataAreaPage>, Int32, Int32, Int32)

This method supports data binning.

When a generic object with two or three measures and one dimension contains a lot of data, groups of points (for example, cells) can be rendered instead of points.

A zone of interest can be refined (for zooming in) up to a maximum refinement level (set in the qQueryLevel parameter) or coarsened (for zoom out).

The grid of cells is adaptive (not static), meaning that it adapts to different length scales.

The GetHyperCubeBinnedData method gives information about the adaptive grid and the values of the generic object.

The number of points in a cell and the coordinates (expressed in the measure range) of each cell are returned.

Dimension values and measure values are rendered at point level (highest detailed level).

Adaptive Grid

More details about the properties of the adaptive grid are given in this paragraph.

When the refinement is not the highest (cells are rendered), information about the adaptive grid is returned through several arrays.

The first array contains the following properties:

Please refer to Engine API reference for table definition.

The next arrays give the coordinates of each cell in the page.

Each array contains the following properties:

Please refer to Engine API reference for table definition.

Dimension values and measures values

More details about the properties, when dimension and measure values are returned, are given in this paragraph.

When the refinement is high, points are rendered (not cells) and dimension and measure values for each cell are returned.

The first array is empty because no information on the adaptive grid is needed.

The next arrays bring information about the dimension and the measure values.

Please refer to Engine API reference for table definition.

GetHyperCubeBinnedDataAsync<T>(AsyncHandle, Func<Response, T>, String, IEnumerable<NxPage>, NxViewPort, IEnumerable<NxDataAreaPage>, Int32, Int32, Int32)

This method supports data binning.

When a generic object with two or three measures and one dimension contains a lot of data, groups of points (for example, cells) can be rendered instead of points.

A zone of interest can be refined (for zooming in) up to a maximum refinement level (set in the qQueryLevel parameter) or coarsened (for zoom out).

The grid of cells is adaptive (not static), meaning that it adapts to different length scales.

The GetHyperCubeBinnedData method gives information about the adaptive grid and the values of the generic object.

The number of points in a cell and the coordinates (expressed in the measure range) of each cell are returned.

Dimension values and measure values are rendered at point level (highest detailed level).

Adaptive Grid

More details about the properties of the adaptive grid are given in this paragraph.

When the refinement is not the highest (cells are rendered), information about the adaptive grid is returned through several arrays.

The first array contains the following properties:

Please refer to Engine API reference for table definition.

The next arrays give the coordinates of each cell in the page.

Each array contains the following properties:

Please refer to Engine API reference for table definition.

Dimension values and measures values

More details about the properties, when dimension and measure values are returned, are given in this paragraph.

When the refinement is high, points are rendered (not cells) and dimension and measure values for each cell are returned.

The first array is empty because no information on the adaptive grid is needed.

The next arrays bring information about the dimension and the measure values.

Please refer to Engine API reference for table definition.

GetHyperCubeBinnedDataAsync(String, IEnumerable<NxPage>, NxViewPort, IEnumerable<NxDataAreaPage>, Int32, Int32, Int32)

This method supports data binning.

When a generic object with two or three measures and one dimension contains a lot of data, groups of points (for example, cells) can be rendered instead of points.

A zone of interest can be refined (for zooming in) up to a maximum refinement level (set in the qQueryLevel parameter) or coarsened (for zoom out).

The grid of cells is adaptive (not static), meaning that it adapts to different length scales.

The GetHyperCubeBinnedData method gives information about the adaptive grid and the values of the generic object.

The number of points in a cell and the coordinates (expressed in the measure range) of each cell are returned.

Dimension values and measure values are rendered at point level (highest detailed level).

Adaptive Grid

More details about the properties of the adaptive grid are given in this paragraph.

When the refinement is not the highest (cells are rendered), information about the adaptive grid is returned through several arrays.

The first array contains the following properties:

Please refer to Engine API reference for table definition.

The next arrays give the coordinates of each cell in the page.

Each array contains the following properties:

Please refer to Engine API reference for table definition.

Dimension values and measures values

More details about the properties, when dimension and measure values are returned, are given in this paragraph.

When the refinement is high, points are rendered (not cells) and dimension and measure values for each cell are returned.

The first array is empty because no information on the adaptive grid is needed.

The next arrays bring information about the dimension and the measure values.

Please refer to Engine API reference for table definition.

Declaration

      Task<IEnumerable<NxDataPage>> GetHyperCubeBinnedDataAsync([QixName("qPath")] string path, [QixName("qPages")] IEnumerable<NxPage> pages, [QixName("qViewport")] NxViewPort viewport, [QixName("qDataRanges")] IEnumerable<NxDataAreaPage> dataRanges, [QixName("qMaxNbrCells")] int maxNbrCells, [QixName("qQueryLevel")] int queryLevel, [QixName("qBinningMethod")] int binningMethod)

Parameters

Type	Name	Description
System.String	path	Path to the definition of the object. For example, `/qHyperCubeDef` .
System.Collections.Generic.IEnumerable<NxPage>	pages	Array of pages to retrieve. Since the generic object contains two measures and one dimension, `qWidth` should be set to 3. If the value of a measure is Null, the value cannot be rendered. Therefore, the number of elements rendered in a page can be less than the number defined in the property `qHeight` .
NxViewPort	viewport	Defines the canvas and the zoom level. This parameter is not yet used and is optional.
System.Collections.Generic.IEnumerable<NxDataAreaPage>	dataRanges	Range of the data to render. This range applies to the measure values. The lowest and highest values of a measure can be retrieved by using the `GetLayout method` (in `/qHyperCube/qMeasureInfo` ).
System.Int32	maxNbrCells	Maximum number of cells in the grid.
System.Int32	queryLevel	Level of details. The higher the level, the more detailed information you get (zoom-in). When the number of points to render falls below a certain threshold, the values are no longer rendered as cells but as points. The query level should be no greater than 20.
System.Int32	binningMethod	Selects the algorithm. The default value is 0. One of: 0: Adaptive grid 1: Hexagonal grid 2: Uniform grid

Returns

Type	Description
System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<NxDataPage>>

Remarks

The generic object should contain two or three measures and one dimension. When the refinement is high, the first two measures are represented on the x-axis and on the y-axis, while the third measure is visualized as color or point size.

GetHyperCubeBinnedDataAsync(AsyncHandle, String, IEnumerable<NxPage>, NxViewPort, IEnumerable<NxDataAreaPage>, Int32, Int32, Int32)

This method supports data binning.

When a generic object with two or three measures and one dimension contains a lot of data, groups of points (for example, cells) can be rendered instead of points.

A zone of interest can be refined (for zooming in) up to a maximum refinement level (set in the qQueryLevel parameter) or coarsened (for zoom out).

The grid of cells is adaptive (not static), meaning that it adapts to different length scales.

The GetHyperCubeBinnedData method gives information about the adaptive grid and the values of the generic object.

The number of points in a cell and the coordinates (expressed in the measure range) of each cell are returned.

Dimension values and measure values are rendered at point level (highest detailed level).

Adaptive Grid

More details about the properties of the adaptive grid are given in this paragraph.

When the refinement is not the highest (cells are rendered), information about the adaptive grid is returned through several arrays.

The first array contains the following properties:

Please refer to Engine API reference for table definition.

The next arrays give the coordinates of each cell in the page.

Each array contains the following properties:

Please refer to Engine API reference for table definition.

Dimension values and measures values

More details about the properties, when dimension and measure values are returned, are given in this paragraph.

When the refinement is high, points are rendered (not cells) and dimension and measure values for each cell are returned.

The first array is empty because no information on the adaptive grid is needed.

The next arrays bring information about the dimension and the measure values.

Please refer to Engine API reference for table definition.

Declaration

      Task<IEnumerable<NxDataPage>> GetHyperCubeBinnedDataAsync(AsyncHandle asyncHandle, [QixName("qPath")] string path, [QixName("qPages")] IEnumerable<NxPage> pages, [QixName("qViewport")] NxViewPort viewport, [QixName("qDataRanges")] IEnumerable<NxDataAreaPage> dataRanges, [QixName("qMaxNbrCells")] int maxNbrCells, [QixName("qQueryLevel")] int queryLevel, [QixName("qBinningMethod")] int binningMethod)

Parameters

Type	Name	Description
AsyncHandle	asyncHandle	Handle to asynchronous method request
System.String	path	Path to the definition of the object. For example, `/qHyperCubeDef` .
System.Collections.Generic.IEnumerable<NxPage>	pages	Array of pages to retrieve. Since the generic object contains two measures and one dimension, `qWidth` should be set to 3. If the value of a measure is Null, the value cannot be rendered. Therefore, the number of elements rendered in a page can be less than the number defined in the property `qHeight` .
NxViewPort	viewport	Defines the canvas and the zoom level. This parameter is not yet used and is optional.
System.Collections.Generic.IEnumerable<NxDataAreaPage>	dataRanges	Range of the data to render. This range applies to the measure values. The lowest and highest values of a measure can be retrieved by using the `GetLayout method` (in `/qHyperCube/qMeasureInfo` ).
System.Int32	maxNbrCells	Maximum number of cells in the grid.
System.Int32	queryLevel	Level of details. The higher the level, the more detailed information you get (zoom-in). When the number of points to render falls below a certain threshold, the values are no longer rendered as cells but as points. The query level should be no greater than 20.
System.Int32	binningMethod	Selects the algorithm. The default value is 0. One of: 0: Adaptive grid 1: Hexagonal grid 2: Uniform grid

Returns

Type	Description
System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<NxDataPage>>

Remarks

GetHyperCubeBinnedDataAsync<T>(AsyncHandle, Func<Response, T>, String, IEnumerable<NxPage>, NxViewPort, IEnumerable<NxDataAreaPage>, Int32, Int32, Int32)

This method supports data binning.

When a generic object with two or three measures and one dimension contains a lot of data, groups of points (for example, cells) can be rendered instead of points.

A zone of interest can be refined (for zooming in) up to a maximum refinement level (set in the qQueryLevel parameter) or coarsened (for zoom out).

The grid of cells is adaptive (not static), meaning that it adapts to different length scales.

The GetHyperCubeBinnedData method gives information about the adaptive grid and the values of the generic object.

The number of points in a cell and the coordinates (expressed in the measure range) of each cell are returned.

Dimension values and measure values are rendered at point level (highest detailed level).

Adaptive Grid

More details about the properties of the adaptive grid are given in this paragraph.

When the refinement is not the highest (cells are rendered), information about the adaptive grid is returned through several arrays.

The first array contains the following properties:

Please refer to Engine API reference for table definition.

The next arrays give the coordinates of each cell in the page.

Each array contains the following properties:

Please refer to Engine API reference for table definition.

Dimension values and measures values

More details about the properties, when dimension and measure values are returned, are given in this paragraph.

When the refinement is high, points are rendered (not cells) and dimension and measure values for each cell are returned.

The first array is empty because no information on the adaptive grid is needed.

The next arrays bring information about the dimension and the measure values.

Please refer to Engine API reference for table definition.

Declaration

      Task<T> GetHyperCubeBinnedDataAsync<T>(AsyncHandle asyncHandle, Func<Response, T> onResult, [QixName("qPath")] string path, [QixName("qPages")] IEnumerable<NxPage> pages, [QixName("qViewport")] NxViewPort viewport, [QixName("qDataRanges")] IEnumerable<NxDataAreaPage> dataRanges, [QixName("qMaxNbrCells")] int maxNbrCells, [QixName("qQueryLevel")] int queryLevel, [QixName("qBinningMethod")] int binningMethod)

Parameters

Type	Name	Description
AsyncHandle	asyncHandle	Handle to asynchronous method request
System.Func<Response, T>	onResult	Continuation function
System.String	path	Path to the definition of the object. For example, `/qHyperCubeDef` .
System.Collections.Generic.IEnumerable<NxPage>	pages	Array of pages to retrieve. Since the generic object contains two measures and one dimension, `qWidth` should be set to 3. If the value of a measure is Null, the value cannot be rendered. Therefore, the number of elements rendered in a page can be less than the number defined in the property `qHeight` .
NxViewPort	viewport	Defines the canvas and the zoom level. This parameter is not yet used and is optional.
System.Collections.Generic.IEnumerable<NxDataAreaPage>	dataRanges	Range of the data to render. This range applies to the measure values. The lowest and highest values of a measure can be retrieved by using the `GetLayout method` (in `/qHyperCube/qMeasureInfo` ).
System.Int32	maxNbrCells	Maximum number of cells in the grid.
System.Int32	queryLevel	Level of details. The higher the level, the more detailed information you get (zoom-in). When the number of points to render falls below a certain threshold, the values are no longer rendered as cells but as points. The query level should be no greater than 20.
System.Int32	binningMethod	Selects the algorithm. The default value is 0. One of: 0: Adaptive grid 1: Hexagonal grid 2: Uniform grid

Returns

Type	Description
System.Threading.Tasks.Task<T>

Type Parameters

Name	Description
T

Remarks

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!

Leave your feedback here