Feat/custom region parser

Description

When creating a Source, you can specify a custom region parser using the from_region method. After the default region has been parsed, the specified parser will be called if it has been set. This allows users to retrieve additional information from the original region by defining their own custom region parser. And, this may be used in issue 74

@classmethod
def from_region(cls, region, parser=None, keep_region=False, **kwargs):
        source = cls(
            # default parser
            a=region.axis_major_length / 2,
            b=region.axis_minor_length / 2,
            orientation=np.pi / 2 - region.orientation,
            coords=np.array(region.centroid_weighted[::-1]),
            peak=region.intensity_max,
            area=region.area,
            **kwargs,
        )

        # custom parser
        if parser is not None:
            parser(source, region)

        return source

Type of Change

[ ] Examples / docs / tutorials / dependencies update
[x] Bug fix (non-breaking change which fixes an issue)
[x] Improvement (non-breaking change which improves an existing feature)
[ ] New feature (non-breaking change which adds functionality)
[ ] Breaking change (fix or feature that would cause existing functionality to change)
[ ] Security fix

Checklist

[x] I've read the CODE_OF_CONDUCT.md document.
[x] I've read the CONTRIBUTING.md guide.
[x] I've updated the code style using black.
[x] I've written tests for all new methods and classes that I created.
[x] I've written the docstring in numpy style for all the methods and classes that I used.

lgrcia / prose

Feat/custom region parser #95

Description

Related Issue

Type of Change

Checklist