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

#include <fpSurface.hpp>

Inheritance diagram for fpSurface:

Collaboration diagram for fpSurface:

Public Member Functions
	fpSurface ()
	Default constructor - allocates new fitpack_surface.

	~fpSurface () override
	Destructor - deallocates if owned.

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

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

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

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

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

	fpSurface (fitpack_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_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_surface_c &	c_handle ()
	Get underlying C wrapper (for interop)

const fitpack_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, std::vector< double > &z, double *w=nullptr)
	new_points

virtual int32_t	new_fit (std::vector< double > &x, std::vector< double > &y, std::vector< double > &z, double w=nullptr, 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	interpolate (bool *reset_knots=nullptr)

virtual int32_t	least_squares (double smoothing=nullptr, 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 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 fpSurface	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.

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

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

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

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

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

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 &	m ()

const int32_t &	m () const

int32_t &	nmax ()

const int32_t &	nmax () const

int32_t &	lwrk2 ()

const int32_t &	lwrk2 () const

int32_t &	bc ()

const int32_t &	bc () 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 fpSurface	make_view ()
	Construct an empty (non-owning) wrapper, for use as a view target.

Protected Member Functions
	fpSurface (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_surface.

This class provides automatic memory management (RAII) and a natural C++ API for the underlying Fortran fitpack_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

◆ fpSurface() [1/6]

fpSurface::fpSurface ( )

inline

Default constructor - allocates new fitpack_surface.

Here is the call graph for this function:

◆ ~fpSurface()

fpSurface::~fpSurface ( )

inlineoverride

Destructor - deallocates if owned.

Here is the call graph for this function:

◆ fpSurface() [2/6]

fpSurface::fpSurface ( const fpSurface & other )

inline

Copy constructor - deep copy.

Here is the call graph for this function:

◆ fpSurface() [3/6]

fpSurface::fpSurface ( fpSurface && other )

inlinenoexcept

Move constructor - transfer ownership.

Here is the call graph for this function:

◆ fpSurface() [4/6]

fpSurface::fpSurface	(	fitpack_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:

◆ fpSurface() [5/6]

fpSurface::fpSurface	(	fitpack_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:

◆ fpSurface() [6/6]

fpSurface::fpSurface ( NoAlloc tag )

inlineexplicitprotected

Here is the call graph for this function:

Member Function Documentation

◆ as_parent() [1/2]

fpFitter & fpSurface::as_parent ( )

inline

Upcast to parent type (reference, no copy)

Here is the call graph for this function:

◆ as_parent() [2/2]

const fpFitter & fpSurface::as_parent ( ) const

inline

Here is the call graph for this function:

◆ bc() [1/2]

int32_t & fpSurface::bc ( )

inline

Here is the call graph for this function:

◆ bc() [2/2]

const int32_t & fpSurface::bc ( ) const

inline

Here is the call graph for this function:

◆ c_handle() [1/2]

fitpack_surface_c & fpSurface::c_handle ( )

inline

Get underlying C wrapper (for interop)

Here is the call graph for this function:

◆ c_handle() [2/2]

const fitpack_surface_c & fpSurface::c_handle ( ) const

inline

Get underlying C wrapper (const, for interop)

Here is the call graph for this function:

◆ c_type_name()

const char * fpSurface::c_type_name ( ) const

inlineoverridevirtual

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

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ comm_expand()

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

inlineoverridevirtual

comm_expand

Implements fpFitter.

Here is the call graph for this function:

◆ comm_pack()

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

inlineoverridevirtual

comm_pack

Implements fpFitter.

Here is the call graph for this function:

◆ comm_size()

int32_t fpSurface::comm_size ( ) const

inlineoverridevirtual

Implements fpFitter.

Here is the call graph for this function:

◆ core_comm_expand()

void fpSurface::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 fpSurface::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 fpSurface::core_comm_size ( ) const

inlineoverridevirtual

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ cpp_type_name()

const char * fpSurface::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 fpSurface::cross_section	(	double	u,
		bool	along_y,
		int32_t *	ierr = nullptr )

inlinevirtual

Here is the call graph for this function:

◆ derivative_spline()

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

inlinevirtual

Here is the call graph for this function:

◆ destroy_base()

void fpSurface::destroy_base ( )

inlineoverridevirtual

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ dfdx() [1/2]

virtual double fpSurface::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 > fpSurface::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 > fpSurface::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 fpSurface::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 > fpSurface::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()

virtual std::vector< double > fpSurface::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 fpSurface::fit	(	double *	smoothing = nullptr,
		int32_t *	order = nullptr,
		bool *	keep_knots = nullptr )

inlinevirtual

Here is the call graph for this function:

◆ integral()

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

inlinevirtual

integral

Here is the call graph for this function:

◆ interpolate()

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

inlinevirtual

Here is the call graph for this function:

◆ is_allocated()

bool fpSurface::is_allocated ( ) const

inlineoverridevirtual

Check if object is allocated.

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ is_pointer()

bool fpSurface::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 fpSurface::least_squares	(	double *	smoothing = nullptr,
		bool *	reset_knots = nullptr )

inlinevirtual

Here is the call graph for this function:

◆ lwrk2() [1/2]

int32_t & fpSurface::lwrk2 ( )

inline

Here is the call graph for this function:

◆ lwrk2() [2/2]

const int32_t & fpSurface::lwrk2 ( ) const

inline

Here is the call graph for this function:

◆ m() [1/2]

int32_t & fpSurface::m ( )

inline

Here is the call graph for this function:

◆ m() [2/2]

const int32_t & fpSurface::m ( ) const

inline

Here is the call graph for this function:

◆ make_view()

static fpSurface fpSurface::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 fpSurface::mse ( ) const

inlineoverridevirtual

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ new_fit()

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

inlinevirtual

new_fit

Here is the call graph for this function:

◆ new_points()

virtual void fpSurface::new_points	(	std::vector< double > &	x,
		std::vector< double > &	y,
		std::vector< double > &	z,
		double *	w = nullptr )

inlinevirtual

new_points

Here is the call graph for this function:

◆ nmax() [1/2]

int32_t & fpSurface::nmax ( )

inline

Here is the call graph for this function:

◆ nmax() [2/2]

const int32_t & fpSurface::nmax ( ) const

inline

Here is the call graph for this function:

◆ operator=() [1/2]

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

inline

Copy assignment - deep copy.

Here is the call graph for this function:

◆ operator=() [2/2]

fpSurface & fpSurface::operator= ( fpSurface && other )

inlinenoexcept

Move assignment - transfer ownership.

Here is the call graph for this function:

◆ t()

fxArray< double > fpSurface::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 > fpSurface::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 > fpSurface::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:

◆ w()

fxArray< double > fpSurface::w ( ) const

inline

Zero-copy fxArray view of component 'w'.

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 w()(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:

◆ w_vector()

std::vector< double > fpSurface::w_vector ( ) const

inline

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

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

Here is the call graph for this function:

◆ wrk2()

fxArray< double > fpSurface::wrk2 ( ) const

inline

Zero-copy fxArray view of component 'wrk2'.

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 wrk2()(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:

◆ wrk2_vector()

std::vector< double > fpSurface::wrk2_vector ( ) const

inline

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

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

Here is the call graph for this function:

◆ x()

fxArray< double > fpSurface::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 > fpSurface::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 > fpSurface::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 > fpSurface::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 > fpSurface::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) 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_vector()

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

inline

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

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:

fpSurface.hpp

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ fpSurface() [1/6]

◆ ~fpSurface()

◆ fpSurface() [2/6]

◆ fpSurface() [3/6]

◆ fpSurface() [4/6]

◆ fpSurface() [5/6]

◆ fpSurface() [6/6]

Member Function Documentation

◆ as_parent() [1/2]

◆ as_parent() [2/2]

◆ bc() [1/2]

◆ bc() [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()

◆ fit()

◆ integral()

◆ interpolate()

◆ is_allocated()

◆ is_pointer()

◆ least_squares()

◆ lwrk2() [1/2]

◆ lwrk2() [2/2]

◆ m() [1/2]

◆ m() [2/2]

◆ make_view()

◆ mse()

◆ new_fit()

◆ new_points()

◆ nmax() [1/2]

◆ nmax() [2/2]

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ t()

◆ t_shape()

◆ t_vector()

◆ w()

◆ w_vector()

◆ wrk2()

◆ wrk2_vector()

◆ x()

◆ x_vector()

◆ y()

◆ y_vector()

◆ z()

◆ z_vector()