number_of_sample_pts

query_ent_var.number_of_sample_pts(p0: int) → int

Specify the number of evenly spaced points to sample either along the line tool or over the specified range of time steps.

This command must lie between either a “query_ent_var: begin” and “query_ent_var: end” pair, or a “query_ent_var: modify_begin” and “query_ent_var: modify_end” pair.

If you specify more or fewer sample points than the number of time steps, EnSight linearly interpolates between the adjoining time steps.

If the query is an FFT sampling, the number of frequencies output will be (a power of two) less than or equal to the number of sample points.

Args:

p0:

‘total_points’ For queries over Distance using the Line Tool, this specifies the number of equally spaced points to query along the line (default = 20). For queries Over Time, this specifies how many evenly timed moments over the specified range of time steps at which to query. If equal to the number of timesteps then you get a sample at each timestep.

Examples:

# 
# Creation example... 
# 
ensight.part.select_begin(1)
ensight.query_ent_var.begin()
ensight.query_ent_var.description("")
# WARNING: following line includes OBSOLETE call (ensight.query_ent_var.type).
ensight.query_ent_var.type("distance")
ensight.query_ent_var.number_of_sample_pts(20)
ensight.query_ent_var.constrain("line_tool")
ensight.query_ent_var.line_loc(1,2.7770e-01,7.7363e-02,1.1348e-02)
ensight.query_ent_var.line_loc(2,7.6144e-01,1.7007e-01,5.5697e-02)
# WARNING: following line includes OBSOLETE call (ensight.query_ent_var.variable).
ensight.query_ent_var.variable("Density")
ensight.query_ent_var.end()
ensight.query_ent_var.query()
ensight.curve.select_begin(0)
# 
# Modification example... 
# 
ensight.query_ent_var.modify_begin()
# WARNING: following line includes OBSOLETE call (ensight.query_ent_var.type).
ensight.query_ent_var.type("distance")
ensight.query_ent_var.number_of_sample_pts(20)
ensight.query_ent_var.constrain("line_tool")
ensight.query_ent_var.modify_end()

Returns:

zero on success, non-zero on error