Standalone C++ RAII wrapper for Fortran fitpack_grid_surface. More...

#include <fpGridSurface.hpp>

Inheritance diagram for fpGridSurface:

Collaboration diagram for fpGridSurface:

Public Member Functions
	fpGridSurface ()
	Default constructor - allocates new fitpack_grid_surface.

	~fpGridSurface () override
	Destructor - deallocates if owned.

	fpGridSurface (const fpGridSurface &other)
	Copy constructor - deep copy.

fpGridSurface &	operator= (const fpGridSurface &other)
	Copy assignment - deep copy.

	fpGridSurface (fpGridSurface &&other) noexcept
	Move constructor - transfer ownership.

fpGridSurface &	operator= (fpGridSurface &&other) noexcept
	Move assignment - transfer ownership.

	fpGridSurface (fitpack_grid_surface_c &c_wrapper, bool move=false)
	Construct from existing C wrapper (takes ownership if move=true)

	fpGridSurface (fitpack_grid_surface_c &c_wrapper, ViewTag)
	Non-owning view ctor: bit-copy the C handle, mark is_pointer=true. Used by parent classes' polymorphic accessors to wrap a base-class handle as the correct concrete subtype.

bool	is_allocated () const override
	Check if object is allocated.

bool	is_pointer () const override
	Check if this is a non-owning pointer.

const char *	c_type_name () const override
	Return the C wrapper struct name for this class (e.g. "fitpack_grid_surface_c").

const char *	cpp_type_name () const override
	Return the fully-qualified C++ class name for this class. Owned by the C++ layer — does not round-trip through Fortran.

fitpack_grid_surface_c &	c_handle ()
	Get underlying C wrapper (for interop)

const fitpack_grid_surface_c &	c_handle () const
	Get underlying C wrapper (const, for interop)

fpFitter &	as_parent ()
	Upcast to parent type (reference, no copy)

const fpFitter &	as_parent () const

virtual void	new_points (std::vector< double > &x, std::vector< double > &y, int32_t z_n1, int32_t z_n2, std::vector< double > &z)
	new_points

virtual int32_t	new_fit (std::vector< double > &x, std::vector< double > &y, int32_t z_n1, int32_t z_n2, std::vector< double > &z, double smoothing=nullptr, int32_t order=nullptr)
	new_fit

virtual int32_t	fit (double smoothing=nullptr, int32_t order=nullptr, bool *keep_knots=nullptr)

virtual int32_t	least_squares (double smoothing=nullptr, bool reset_knots=nullptr)

virtual int32_t	interpolate (bool *reset_knots=nullptr)

virtual double	eval (double x, double y, int32_t *ierr=nullptr)

virtual std::vector< double >	eval (std::vector< double > &x, std::vector< double > &y, int32_t *ierr=nullptr)
	eval

virtual double	eval_ongrid (double x, double y, int32_t *ierr=nullptr)

virtual std::vector< double >	eval_ongrid (std::vector< double > &x, std::vector< double > &y, int32_t *ierr=nullptr)
	eval_ongrid

virtual double	dfdx (double x, double y, int32_t dx, int32_t dy, int32_t *ierr=nullptr)

virtual std::vector< double >	dfdx (std::vector< double > &x, std::vector< double > &y, int32_t dx, int32_t dy, int32_t *ierr=nullptr)
	dfdx

virtual std::vector< double >	dfdx_ongrid (std::vector< double > &x, std::vector< double > &y, int32_t dx, int32_t dy, int32_t *ierr=nullptr)
	dfdx_ongrid

virtual double	integral (std::vector< double > &lower, std::vector< double > &upper) const
	integral

virtual fpCurve	cross_section (double u, bool along_y, int32_t *ierr=nullptr)

virtual fpGridSurface	derivative_spline (int32_t nux, int32_t nuy, int32_t *ierr=nullptr)

int32_t	comm_size () const override

void	comm_pack (std::vector< double > &buffer) const override
	comm_pack

void	comm_expand (std::vector< double > &buffer) override
	comm_expand

double	mse () const override

int32_t	core_comm_size () const override

void	core_comm_pack (std::vector< double > &buffer) const override
	core_comm_pack

void	core_comm_expand (std::vector< double > &buffer) override
	core_comm_expand

void	destroy_base () override

std::vector< double >	x_vector () const
	Deep copy of component 'x' as a std::vector.

fxArray< double >	x () const
	Zero-copy fxArray view of component 'x'.

std::vector< double >	y_vector () const
	Deep copy of component 'y' as a std::vector.

fxArray< double >	y () const
	Zero-copy fxArray view of component 'y'.

std::vector< double >	z_vector () const
	Deep copy of component 'z' as a std::vector.

std::array< int64_t, 2 >	z_shape () const
	Extents of component 'z', leading dimension first.

fxArray< double >	z () const
	Zero-copy fxArray view of component 'z'.

std::vector< double >	t_vector () const
	Deep copy of component 't' as a std::vector.

std::array< int64_t, 2 >	t_shape () const
	Extents of component 't', leading dimension first.

fxArray< double >	t () const
	Zero-copy fxArray view of component 't'.

int32_t &	nmax ()

const int32_t &	nmax () const

Public Member Functions inherited from fpFitter
virtual	~fpFitter ()=default

const char *	fortran_type_name () const
	Return the dynamic Fortran type name of the underlying object.

fitpack_fitter_c &	c_handle ()
	Get underlying C wrapper (for interop)

const fitpack_fitter_c &	c_handle () const
	Get underlying C wrapper (const, for interop)

std::vector< double >	c_vector () const
	Deep copy of component 'c' as a std::vector.

fxArray< double >	c () const
	Zero-copy fxArray view of component 'c'.

std::vector< double >	wrk_vector () const
	Deep copy of component 'wrk' as a std::vector.

fxArray< double >	wrk () const
	Zero-copy fxArray view of component 'wrk'.

std::vector< int32_t >	iwrk_vector () const
	Deep copy of component 'iwrk' as a std::vector.

fxArray< int32_t >	iwrk () const
	Zero-copy fxArray view of component 'iwrk'.

int32_t &	iopt ()

const int32_t &	iopt () const

double &	smoothing ()

const double &	smoothing () const

double &	fp ()

const double &	fp () const

int32_t &	lwrk ()

const int32_t &	lwrk () const

int32_t &	liwrk ()

const int32_t &	liwrk () const

Static Public Member Functions
static fpGridSurface	make_view ()
	Construct an empty (non-owning) wrapper, for use as a view target.

Protected Member Functions
	fpGridSurface (NoAlloc tag)

Protected Member Functions inherited from fpFitter
	fpFitter (NoAlloc)
	Protected constructor for derived classes (does not allocate)

template<typename T>
T *	as ()

template<typename T>
const T *	as () const

Additional Inherited Members
Protected Attributes inherited from fpFitter
fitpack_fitter_c	cobj = fitpack_fitter_c_null

Detailed Description

Standalone C++ RAII wrapper for Fortran fitpack_grid_surface.

This class provides automatic memory management (RAII) and a natural C++ API for the underlying Fortran fitpack_grid_surface, without requiring the fortran-arrays library. Array arguments use std::vector<T> for standalone operation. Extends fpFitter (Fortran: extends(fitpack_fitter))

Constructor & Destructor Documentation

◆ fpGridSurface() [1/6]

fpGridSurface::fpGridSurface ( )

inline

Default constructor - allocates new fitpack_grid_surface.

Here is the call graph for this function:

◆ ~fpGridSurface()

fpGridSurface::~fpGridSurface ( )

inlineoverride

Destructor - deallocates if owned.

Here is the call graph for this function:

◆ fpGridSurface() [2/6]

fpGridSurface::fpGridSurface ( const fpGridSurface & other )

inline

Copy constructor - deep copy.

Here is the call graph for this function:

◆ fpGridSurface() [3/6]

fpGridSurface::fpGridSurface ( fpGridSurface && other )

inlinenoexcept

Move constructor - transfer ownership.

Here is the call graph for this function:

◆ fpGridSurface() [4/6]

fpGridSurface::fpGridSurface	(	fitpack_grid_surface_c &	c_wrapper,
		bool	move = false )

inlineexplicit

Construct from existing C wrapper (takes ownership if move=true)

Here is the call graph for this function:

◆ fpGridSurface() [5/6]

fpGridSurface::fpGridSurface	(	fitpack_grid_surface_c &	c_wrapper,
		ViewTag	)

inlineexplicit

Non-owning view ctor: bit-copy the C handle, mark is_pointer=true. Used by parent classes' polymorphic accessors to wrap a base-class handle as the correct concrete subtype.

Here is the call graph for this function:

◆ fpGridSurface() [6/6]

fpGridSurface::fpGridSurface ( NoAlloc tag )

inlineexplicitprotected

Here is the call graph for this function:

Member Function Documentation

◆ as_parent() [1/2]

fpFitter & fpGridSurface::as_parent ( )

inline

Upcast to parent type (reference, no copy)

Here is the call graph for this function:

◆ as_parent() [2/2]

const fpFitter & fpGridSurface::as_parent ( ) const

inline

Here is the call graph for this function:

◆ c_handle() [1/2]

fitpack_grid_surface_c & fpGridSurface::c_handle ( )

inline

Get underlying C wrapper (for interop)

Here is the call graph for this function:

◆ c_handle() [2/2]

const fitpack_grid_surface_c & fpGridSurface::c_handle ( ) const

inline

Get underlying C wrapper (const, for interop)

Here is the call graph for this function:

◆ c_type_name()

const char * fpGridSurface::c_type_name ( ) const

inlineoverridevirtual

Return the C wrapper struct name for this class (e.g. "fitpack_grid_surface_c").

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ comm_expand()

void fpGridSurface::comm_expand ( std::vector< double > & buffer )

inlineoverridevirtual

comm_expand

Implements fpFitter.

Here is the call graph for this function:

◆ comm_pack()

void fpGridSurface::comm_pack ( std::vector< double > & buffer ) const

inlineoverridevirtual

comm_pack

Implements fpFitter.

Here is the call graph for this function:

◆ comm_size()

int32_t fpGridSurface::comm_size ( ) const

inlineoverridevirtual

Implements fpFitter.

Here is the call graph for this function:

◆ core_comm_expand()

void fpGridSurface::core_comm_expand ( std::vector< double > & buffer )

inlineoverridevirtual

core_comm_expand

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ core_comm_pack()

void fpGridSurface::core_comm_pack ( std::vector< double > & buffer ) const

inlineoverridevirtual

core_comm_pack

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ core_comm_size()

int32_t fpGridSurface::core_comm_size ( ) const

inlineoverridevirtual

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ cpp_type_name()

const char * fpGridSurface::cpp_type_name ( ) const

inlineoverridevirtual

Return the fully-qualified C++ class name for this class. Owned by the C++ layer — does not round-trip through Fortran.

Reimplemented from fpFitter.

◆ cross_section()

virtual fpCurve fpGridSurface::cross_section	(	double	u,
		bool	along_y,
		int32_t *	ierr = nullptr )

inlinevirtual

Here is the call graph for this function:

◆ derivative_spline()

virtual fpGridSurface fpGridSurface::derivative_spline	(	int32_t	nux,
		int32_t	nuy,
		int32_t *	ierr = nullptr )

inlinevirtual

Here is the call graph for this function:

◆ destroy_base()

void fpGridSurface::destroy_base ( )

inlineoverridevirtual

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ dfdx() [1/2]

virtual double fpGridSurface::dfdx	(	double	x,
		double	y,
		int32_t	dx,
		int32_t	dy,
		int32_t *	ierr = nullptr )

inlinevirtual

Here is the call graph for this function:

◆ dfdx() [2/2]

virtual std::vector< double > fpGridSurface::dfdx	(	std::vector< double > &	x,
		std::vector< double > &	y,
		int32_t	dx,
		int32_t	dy,
		int32_t *	ierr = nullptr )

inlinevirtual

dfdx

Here is the call graph for this function:

◆ dfdx_ongrid()

virtual std::vector< double > fpGridSurface::dfdx_ongrid	(	std::vector< double > &	x,
		std::vector< double > &	y,
		int32_t	dx,
		int32_t	dy,
		int32_t *	ierr = nullptr )

inlinevirtual

dfdx_ongrid

Here is the call graph for this function:

◆ eval() [1/2]

virtual double fpGridSurface::eval	(	double	x,
		double	y,
		int32_t *	ierr = nullptr )

inlinevirtual

Here is the call graph for this function:

◆ eval() [2/2]

virtual std::vector< double > fpGridSurface::eval	(	std::vector< double > &	x,
		std::vector< double > &	y,
		int32_t *	ierr = nullptr )

inlinevirtual

eval

Here is the call graph for this function:

◆ eval_ongrid() [1/2]

virtual double fpGridSurface::eval_ongrid	(	double	x,
		double	y,
		int32_t *	ierr = nullptr )

inlinevirtual

Here is the call graph for this function:

◆ eval_ongrid() [2/2]

virtual std::vector< double > fpGridSurface::eval_ongrid	(	std::vector< double > &	x,
		std::vector< double > &	y,
		int32_t *	ierr = nullptr )

inlinevirtual

eval_ongrid

Here is the call graph for this function:

◆ fit()

virtual int32_t fpGridSurface::fit	(	double *	smoothing = nullptr,
		int32_t *	order = nullptr,
		bool *	keep_knots = nullptr )

inlinevirtual

Here is the call graph for this function:

◆ integral()

virtual double fpGridSurface::integral	(	std::vector< double > &	lower,
		std::vector< double > &	upper ) const

inlinevirtual

integral

Here is the call graph for this function:

◆ interpolate()

virtual int32_t fpGridSurface::interpolate ( bool * reset_knots = nullptr )

inlinevirtual

Here is the call graph for this function:

◆ is_allocated()

bool fpGridSurface::is_allocated ( ) const

inlineoverridevirtual

Check if object is allocated.

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ is_pointer()

bool fpGridSurface::is_pointer ( ) const

inlineoverridevirtual

Check if this is a non-owning pointer.

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ least_squares()

virtual int32_t fpGridSurface::least_squares	(	double *	smoothing = nullptr,
		bool *	reset_knots = nullptr )

inlinevirtual

Here is the call graph for this function:

◆ make_view()

static fpGridSurface fpGridSurface::make_view ( )

inlinestatic

Construct an empty (non-owning) wrapper, for use as a view target.

The returned object has a null handle (cptr==nullptr, is_pointer==false) and does NOT allocate a Fortran object. Intended as a fill target for member-view accessors emitted on parent types — the parent populates the handle with c_loc() into its own storage and sets is_pointer=true.

Here is the call graph for this function:

◆ mse()

double fpGridSurface::mse ( ) const

inlineoverridevirtual

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ new_fit()

virtual int32_t fpGridSurface::new_fit	(	std::vector< double > &	x,
		std::vector< double > &	y,
		int32_t	z_n1,
		int32_t	z_n2,
		std::vector< double > &	z,
		double *	smoothing = nullptr,
		int32_t *	order = nullptr )

inlinevirtual

new_fit

Here is the call graph for this function:

◆ new_points()

virtual void fpGridSurface::new_points	(	std::vector< double > &	x,
		std::vector< double > &	y,
		int32_t	z_n1,
		int32_t	z_n2,
		std::vector< double > &	z )

inlinevirtual

new_points

Here is the call graph for this function:

◆ nmax() [1/2]

int32_t & fpGridSurface::nmax ( )

inline

Here is the call graph for this function:

◆ nmax() [2/2]

const int32_t & fpGridSurface::nmax ( ) const

inline

Here is the call graph for this function:

◆ operator=() [1/2]

fpGridSurface & fpGridSurface::operator= ( const fpGridSurface & other )

inline

Copy assignment - deep copy.

Here is the call graph for this function:

◆ operator=() [2/2]

fpGridSurface & fpGridSurface::operator= ( fpGridSurface && other )

inlinenoexcept

Move assignment - transfer ownership.

Here is the call graph for this function:

◆ t()

fxArray< double > fpGridSurface::t ( ) const

inline

Zero-copy fxArray view of component 't'.

array_c_from_ptr builds the descriptor from the borrowed pointer and bounds, so the view aliases the Fortran storage directly — nothing is copied and writes through t()(i, j) land in the object.

Note: Only available when the Fortran-Arrays library is present and enabled (HAVE_FXARRAY).

Warning: The view is invalidated by any refit, assignment or destroy call on this object; re-read it rather than retaining it.

Here is the call graph for this function:

◆ t_shape()

std::array< int64_t, 2 > fpGridSurface::t_shape ( ) const

inline

Extents of component 't', leading dimension first.

Returns: All zeros when the component is unallocated.

Here is the call graph for this function:

◆ t_vector()

std::vector< double > fpGridSurface::t_vector ( ) const

inline

Deep copy of component 't' as a std::vector.

The rank-2 component is flattened COLUMN-MAJOR (Fortran order): element (i, j, ...) — zero-based — is at index i + j * extents[0] + ... Query the extents with t_shape().

Returns: An owning copy, empty when the component is unallocated.

Here is the call graph for this function:

◆ x()

fxArray< double > fpGridSurface::x ( ) const

inline

Zero-copy fxArray view of component 'x'.

array_c_from_ptr builds the descriptor from the borrowed pointer and bounds, so the view aliases the Fortran storage directly — nothing is copied and writes through x()(i) land in the object.

Note: Only available when the Fortran-Arrays library is present and enabled (HAVE_FXARRAY).

Warning: The view is invalidated by any refit, assignment or destroy call on this object; re-read it rather than retaining it.

Here is the call graph for this function:

◆ x_vector()

std::vector< double > fpGridSurface::x_vector ( ) const

inline

Deep copy of component 'x' as a std::vector.

Returns: An owning copy, empty when the component is unallocated.

Here is the call graph for this function:

◆ y()

fxArray< double > fpGridSurface::y ( ) const

inline

Zero-copy fxArray view of component 'y'.

array_c_from_ptr builds the descriptor from the borrowed pointer and bounds, so the view aliases the Fortran storage directly — nothing is copied and writes through y()(i) land in the object.

Note: Only available when the Fortran-Arrays library is present and enabled (HAVE_FXARRAY).

Warning: The view is invalidated by any refit, assignment or destroy call on this object; re-read it rather than retaining it.

Here is the call graph for this function:

◆ y_vector()

std::vector< double > fpGridSurface::y_vector ( ) const

inline

Deep copy of component 'y' as a std::vector.

Returns: An owning copy, empty when the component is unallocated.

Here is the call graph for this function:

◆ z()

fxArray< double > fpGridSurface::z ( ) const

inline

Zero-copy fxArray view of component 'z'.

array_c_from_ptr builds the descriptor from the borrowed pointer and bounds, so the view aliases the Fortran storage directly — nothing is copied and writes through z()(i, j) land in the object.

Note: Only available when the Fortran-Arrays library is present and enabled (HAVE_FXARRAY).

Warning: The view is invalidated by any refit, assignment or destroy call on this object; re-read it rather than retaining it.

Here is the call graph for this function:

◆ z_shape()

std::array< int64_t, 2 > fpGridSurface::z_shape ( ) const

inline

Extents of component 'z', leading dimension first.

Returns: All zeros when the component is unallocated.

Here is the call graph for this function:

◆ z_vector()

std::vector< double > fpGridSurface::z_vector ( ) const

inline

Deep copy of component 'z' as a std::vector.

The rank-2 component is flattened COLUMN-MAJOR (Fortran order): element (i, j, ...) — zero-based — is at index i + j * extents[0] + ... Query the extents with z_shape().

Returns: An owning copy, empty when the component is unallocated.

Here is the call graph for this function:

The documentation for this class was generated from the following file:

fpGridSurface.hpp

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ fpGridSurface() [1/6]

◆ ~fpGridSurface()

◆ fpGridSurface() [2/6]

◆ fpGridSurface() [3/6]

◆ fpGridSurface() [4/6]

◆ fpGridSurface() [5/6]

◆ fpGridSurface() [6/6]

Member Function Documentation

◆ as_parent() [1/2]

◆ as_parent() [2/2]

◆ c_handle() [1/2]

◆ c_handle() [2/2]

◆ c_type_name()

◆ comm_expand()

◆ comm_pack()

◆ comm_size()

◆ core_comm_expand()

◆ core_comm_pack()

◆ core_comm_size()

◆ cpp_type_name()

◆ cross_section()

◆ derivative_spline()

◆ destroy_base()

◆ dfdx() [1/2]

◆ dfdx() [2/2]

◆ dfdx_ongrid()

◆ eval() [1/2]

◆ eval() [2/2]

◆ eval_ongrid() [1/2]

◆ eval_ongrid() [2/2]

◆ fit()

◆ integral()

◆ interpolate()

◆ is_allocated()

◆ is_pointer()

◆ least_squares()

◆ make_view()

◆ mse()

◆ new_fit()

◆ new_points()

◆ nmax() [1/2]

◆ nmax() [2/2]

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ t()

◆ t_shape()

◆ t_vector()

◆ x()

◆ x_vector()

◆ y()

◆ y_vector()

◆ z()

◆ z_shape()

◆ z_vector()