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

#include <fpSphere.hpp>

Inheritance diagram for fpSphere:

Collaboration diagram for fpSphere:

Public Member Functions
	fpSphere ()
	Default constructor - allocates new fitpack_sphere.

	~fpSphere () override
	Destructor - deallocates if owned.

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

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

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

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

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

	fpSphere (fitpack_sphere_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_sphere_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_sphere_c &	c_handle ()
	Get underlying C wrapper (for interop)

const fitpack_sphere_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 > &theta, std::vector< double > &phi, std::vector< double > &r, double *w=nullptr)
	new_points

virtual int32_t	new_fit (std::vector< double > &theta, std::vector< double > &phi, std::vector< double > &r, double w=nullptr, double smoothing=nullptr)
	new_fit

virtual int32_t	fit (double smoothing=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 theta, double phi, int32_t *ierr=nullptr)

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

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 >	theta_vector () const
	Deep copy of component 'theta' as a std::vector.

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

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

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

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

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

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

const int32_t &	lwrk2 () const

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

Protected Member Functions
	fpSphere (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_sphere.

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

Constructor & Destructor Documentation

◆ fpSphere() [1/6]

fpSphere::fpSphere ( )

inline

Default constructor - allocates new fitpack_sphere.

Here is the call graph for this function:

◆ ~fpSphere()

fpSphere::~fpSphere ( )

inlineoverride

Destructor - deallocates if owned.

Here is the call graph for this function:

◆ fpSphere() [2/6]

fpSphere::fpSphere ( const fpSphere & other )

inline

Copy constructor - deep copy.

Here is the call graph for this function:

◆ fpSphere() [3/6]

fpSphere::fpSphere ( fpSphere && other )

inlinenoexcept

Move constructor - transfer ownership.

Here is the call graph for this function:

◆ fpSphere() [4/6]

fpSphere::fpSphere	(	fitpack_sphere_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:

◆ fpSphere() [5/6]

fpSphere::fpSphere	(	fitpack_sphere_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:

◆ fpSphere() [6/6]

fpSphere::fpSphere ( NoAlloc tag )

inlineexplicitprotected

Here is the call graph for this function:

Member Function Documentation

◆ as_parent() [1/2]

fpFitter & fpSphere::as_parent ( )

inline

Upcast to parent type (reference, no copy)

Here is the call graph for this function:

◆ as_parent() [2/2]

const fpFitter & fpSphere::as_parent ( ) const

inline

Here is the call graph for this function:

◆ c_handle() [1/2]

fitpack_sphere_c & fpSphere::c_handle ( )

inline

Get underlying C wrapper (for interop)

Here is the call graph for this function:

◆ c_handle() [2/2]

const fitpack_sphere_c & fpSphere::c_handle ( ) const

inline

Get underlying C wrapper (const, for interop)

Here is the call graph for this function:

◆ c_type_name()

const char * fpSphere::c_type_name ( ) const

inlineoverridevirtual

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

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ comm_expand()

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

inlineoverridevirtual

comm_expand

Implements fpFitter.

Here is the call graph for this function:

◆ comm_pack()

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

inlineoverridevirtual

comm_pack

Implements fpFitter.

Here is the call graph for this function:

◆ comm_size()

int32_t fpSphere::comm_size ( ) const

inlineoverridevirtual

Implements fpFitter.

Here is the call graph for this function:

◆ core_comm_expand()

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

inlineoverridevirtual

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ cpp_type_name()

const char * fpSphere::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.

◆ destroy_base()

void fpSphere::destroy_base ( )

inlineoverridevirtual

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ eval() [1/2]

virtual double fpSphere::eval	(	double	theta,
		double	phi,
		int32_t *	ierr = nullptr )

inlinevirtual

Here is the call graph for this function:

◆ eval() [2/2]

virtual std::vector< double > fpSphere::eval	(	std::vector< double > &	theta,
		std::vector< double > &	phi,
		int32_t *	ierr = nullptr )

inlinevirtual

eval

Here is the call graph for this function:

◆ fit()

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

inlinevirtual

Here is the call graph for this function:

◆ interpolate()

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

inlinevirtual

Here is the call graph for this function:

◆ is_allocated()

bool fpSphere::is_allocated ( ) const

inlineoverridevirtual

Check if object is allocated.

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ is_pointer()

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

inlinevirtual

Here is the call graph for this function:

◆ lwrk2() [1/2]

int32_t & fpSphere::lwrk2 ( )

inline

Here is the call graph for this function:

◆ lwrk2() [2/2]

const int32_t & fpSphere::lwrk2 ( ) const

inline

Here is the call graph for this function:

◆ m() [1/2]

int32_t & fpSphere::m ( )

inline

Here is the call graph for this function:

◆ m() [2/2]

const int32_t & fpSphere::m ( ) const

inline

Here is the call graph for this function:

◆ make_view()

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

inlineoverridevirtual

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ new_fit()

virtual int32_t fpSphere::new_fit	(	std::vector< double > &	theta,
		std::vector< double > &	phi,
		std::vector< double > &	r,
		double *	w = nullptr,
		double *	smoothing = nullptr )

inlinevirtual

new_fit

Here is the call graph for this function:

◆ new_points()

virtual void fpSphere::new_points	(	std::vector< double > &	theta,
		std::vector< double > &	phi,
		std::vector< double > &	r,
		double *	w = nullptr )

inlinevirtual

new_points

Here is the call graph for this function:

◆ nmax() [1/2]

int32_t & fpSphere::nmax ( )

inline

Here is the call graph for this function:

◆ nmax() [2/2]

const int32_t & fpSphere::nmax ( ) const

inline

Here is the call graph for this function:

◆ operator=() [1/2]

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

inline

Copy assignment - deep copy.

Here is the call graph for this function:

◆ operator=() [2/2]

fpSphere & fpSphere::operator= ( fpSphere && other )

inlinenoexcept

Move assignment - transfer ownership.

Here is the call graph for this function:

◆ phi()

fxArray< double > fpSphere::phi ( ) const

inline

Zero-copy fxArray view of component 'phi'.

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

◆ phi_vector()

std::vector< double > fpSphere::phi_vector ( ) const

inline

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

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

Here is the call graph for this function:

◆ r()

fxArray< double > fpSphere::r ( ) const

inline

Zero-copy fxArray view of component 'r'.

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

◆ r_vector()

std::vector< double > fpSphere::r_vector ( ) const

inline

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

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

Here is the call graph for this function:

◆ t()

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

◆ theta()

fxArray< double > fpSphere::theta ( ) const

inline

Zero-copy fxArray view of component 'theta'.

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

◆ theta_vector()

std::vector< double > fpSphere::theta_vector ( ) const

inline

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

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

Here is the call graph for this function:

◆ w()

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

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

fpSphere.hpp

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ fpSphere() [1/6]

◆ ~fpSphere()

◆ fpSphere() [2/6]

◆ fpSphere() [3/6]

◆ fpSphere() [4/6]

◆ fpSphere() [5/6]

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

◆ destroy_base()

◆ eval() [1/2]

◆ eval() [2/2]

◆ fit()

◆ 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]

◆ phi()

◆ phi_vector()

◆ r()

◆ r_vector()

◆ t()

◆ t_shape()

◆ t_vector()

◆ theta()

◆ theta_vector()

◆ w()

◆ w_vector()

◆ wrk2()

◆ wrk2_vector()