fitpack
Modern Fortran library for curve and surface fitting with splines
Loading...
Searching...
No Matches
fpPolar Class Reference

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

#include <fpPolar.hpp>

Inheritance diagram for fpPolar:
Collaboration diagram for fpPolar:

Public Member Functions

 fpPolar ()
 Default constructor - allocates new fitpack_polar.
 
 ~fpPolar () override
 Destructor - deallocates if owned.
 
 fpPolar (const fpPolar &other)
 Copy constructor - deep copy.
 
fpPolaroperator= (const fpPolar &other)
 Copy assignment - deep copy.
 
 fpPolar (fpPolar &&other) noexcept
 Move constructor - transfer ownership.
 
fpPolaroperator= (fpPolar &&other) noexcept
 Move assignment - transfer ownership.
 
 fpPolar (fitpack_polar_c &c_wrapper, bool move=false)
 Construct from existing C wrapper (takes ownership if move=true)
 
 fpPolar (fitpack_polar_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_polar_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_polar_c & c_handle ()
 Get underlying C wrapper (for interop)
 
const fitpack_polar_c & c_handle () const
 Get underlying C wrapper (const, for interop)
 
fpFitteras_parent ()
 Upcast to parent type (reference, no copy)
 
const fpFitteras_parent () const
 
virtual void new_points (std::vector< double > &x, std::vector< double > &y, std::vector< double > &z, fitpack_polar_boundary_fn boundary, double *w=nullptr, int32_t *boundary_bc=nullptr)
 new_points
 
virtual int32_t new_fit (std::vector< double > &x, std::vector< double > &y, std::vector< double > &z, fitpack_polar_boundary_fn boundary, double *w=nullptr, int32_t *boundary_bc=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 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
 
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 > u_vector () const
 Deep copy of component 'u' as a std::vector.
 
fxArray< double > u () const
 Zero-copy fxArray view of component 'u'.
 
std::vector< double > v_vector () const
 Deep copy of component 'v' as a std::vector.
 
fxArray< double > v () const
 Zero-copy fxArray view of component 'v'.
 
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 & bc_continuity_origin ()
 
const int32_t & bc_continuity_origin () const
 
int32_t & bc_boundary ()
 
const int32_t & bc_boundary () 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 fpPolar make_view ()
 Construct an empty (non-owning) wrapper, for use as a view target.
 

Protected Member Functions

 fpPolar (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_polar.

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

Constructor & Destructor Documentation

◆ fpPolar() [1/6]

fpPolar::fpPolar ( )
inline

Default constructor - allocates new fitpack_polar.

Here is the call graph for this function:

◆ ~fpPolar()

fpPolar::~fpPolar ( )
inlineoverride

Destructor - deallocates if owned.

Here is the call graph for this function:

◆ fpPolar() [2/6]

fpPolar::fpPolar ( const fpPolar & other)
inline

Copy constructor - deep copy.

Here is the call graph for this function:

◆ fpPolar() [3/6]

fpPolar::fpPolar ( fpPolar && other)
inlinenoexcept

Move constructor - transfer ownership.

Here is the call graph for this function:

◆ fpPolar() [4/6]

fpPolar::fpPolar ( fitpack_polar_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:

◆ fpPolar() [5/6]

fpPolar::fpPolar ( fitpack_polar_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:

◆ fpPolar() [6/6]

fpPolar::fpPolar ( NoAlloc tag)
inlineexplicitprotected
Here is the call graph for this function:

Member Function Documentation

◆ as_parent() [1/2]

fpFitter & fpPolar::as_parent ( )
inline

Upcast to parent type (reference, no copy)

Here is the call graph for this function:

◆ as_parent() [2/2]

const fpFitter & fpPolar::as_parent ( ) const
inline
Here is the call graph for this function:

◆ bc_boundary() [1/2]

int32_t & fpPolar::bc_boundary ( )
inline
Here is the call graph for this function:

◆ bc_boundary() [2/2]

const int32_t & fpPolar::bc_boundary ( ) const
inline
Here is the call graph for this function:

◆ bc_continuity_origin() [1/2]

int32_t & fpPolar::bc_continuity_origin ( )
inline
Here is the call graph for this function:

◆ bc_continuity_origin() [2/2]

const int32_t & fpPolar::bc_continuity_origin ( ) const
inline
Here is the call graph for this function:

◆ c_handle() [1/2]

fitpack_polar_c & fpPolar::c_handle ( )
inline

Get underlying C wrapper (for interop)

Here is the call graph for this function:

◆ c_handle() [2/2]

const fitpack_polar_c & fpPolar::c_handle ( ) const
inline

Get underlying C wrapper (const, for interop)

Here is the call graph for this function:

◆ c_type_name()

const char * fpPolar::c_type_name ( ) const
inlineoverridevirtual

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

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ comm_expand()

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

comm_expand

Implements fpFitter.

Here is the call graph for this function:

◆ comm_pack()

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

comm_pack

Implements fpFitter.

Here is the call graph for this function:

◆ comm_size()

int32_t fpPolar::comm_size ( ) const
inlineoverridevirtual

Implements fpFitter.

Here is the call graph for this function:

◆ core_comm_expand()

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

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ cpp_type_name()

const char * fpPolar::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 fpPolar::destroy_base ( )
inlineoverridevirtual

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ eval() [1/2]

virtual double fpPolar::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 > fpPolar::eval ( std::vector< double > & x,
std::vector< double > & y,
int32_t * ierr = nullptr )
inlinevirtual

eval

Here is the call graph for this function:

◆ fit()

virtual int32_t fpPolar::fit ( double * smoothing = nullptr,
bool * keep_knots = nullptr )
inlinevirtual
Here is the call graph for this function:

◆ interpolate()

virtual int32_t fpPolar::interpolate ( bool * reset_knots = nullptr)
inlinevirtual
Here is the call graph for this function:

◆ is_allocated()

bool fpPolar::is_allocated ( ) const
inlineoverridevirtual

Check if object is allocated.

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ is_pointer()

bool fpPolar::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 fpPolar::least_squares ( double * smoothing = nullptr,
bool * reset_knots = nullptr )
inlinevirtual
Here is the call graph for this function:

◆ lwrk2() [1/2]

int32_t & fpPolar::lwrk2 ( )
inline
Here is the call graph for this function:

◆ lwrk2() [2/2]

const int32_t & fpPolar::lwrk2 ( ) const
inline
Here is the call graph for this function:

◆ m() [1/2]

int32_t & fpPolar::m ( )
inline
Here is the call graph for this function:

◆ m() [2/2]

const int32_t & fpPolar::m ( ) const
inline
Here is the call graph for this function:

◆ make_view()

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

Reimplemented from fpFitter.

Here is the call graph for this function:

◆ new_fit()

virtual int32_t fpPolar::new_fit ( std::vector< double > & x,
std::vector< double > & y,
std::vector< double > & z,
fitpack_polar_boundary_fn boundary,
double * w = nullptr,
int32_t * boundary_bc = nullptr,
double * smoothing = nullptr )
inlinevirtual

new_fit

Here is the call graph for this function:

◆ new_points()

virtual void fpPolar::new_points ( std::vector< double > & x,
std::vector< double > & y,
std::vector< double > & z,
fitpack_polar_boundary_fn boundary,
double * w = nullptr,
int32_t * boundary_bc = nullptr )
inlinevirtual

new_points

Here is the call graph for this function:

◆ nmax() [1/2]

int32_t & fpPolar::nmax ( )
inline
Here is the call graph for this function:

◆ nmax() [2/2]

const int32_t & fpPolar::nmax ( ) const
inline
Here is the call graph for this function:

◆ operator=() [1/2]

fpPolar & fpPolar::operator= ( const fpPolar & other)
inline

Copy assignment - deep copy.

Here is the call graph for this function:

◆ operator=() [2/2]

fpPolar & fpPolar::operator= ( fpPolar && other)
inlinenoexcept

Move assignment - transfer ownership.

Here is the call graph for this function:

◆ t()

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

◆ u()

fxArray< double > fpPolar::u ( ) const
inline

Zero-copy fxArray view of component 'u'.

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

◆ u_vector()

std::vector< double > fpPolar::u_vector ( ) const
inline

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

Returns
An owning copy, empty when the component is unallocated.
Here is the call graph for this function:

◆ v()

fxArray< double > fpPolar::v ( ) const
inline

Zero-copy fxArray view of component 'v'.

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

◆ v_vector()

std::vector< double > fpPolar::v_vector ( ) const
inline

Deep copy of component 'v' 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 > fpPolar::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 > fpPolar::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 > fpPolar::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 > fpPolar::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 > fpPolar::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 > fpPolar::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 > fpPolar::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 > fpPolar::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 > fpPolar::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 > fpPolar::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: