source: cpp/frams/genetics/genoconv.h @ 821

Last change on this file since 821 was 783, checked in by Maciej Komosinski, 6 years ago

Removed the unused "info" field and fixed a bug with incorrect pointers to content stored in a vector

  • Property svn:eol-style set to native
File size: 3.5 KB
Line 
1// This file is a part of Framsticks SDK.  http://www.framsticks.com/
2// Copyright (C) 1999-2018  Maciej Komosinski and Szymon Ulatowski.
3// See LICENSE.txt for details.
4
5#ifndef _GENCONV_H_
6#define _GENCONV_H_
7
8#include "geno.h"
9#include <frams/param/param.h>
10#include <frams/util/list.h>
11#include <frams/util/sstring.h>
12
13#include <string>
14#include <vector>
15
16
17class GenoConvManager;
18
19class GenoConvParam : public Param
20{
21        GenoConvManager *gcm;
22        std::vector<std::string> gcnames; //stores names of converters so that these names persist and pointers to these names can be safely used externally
23        char tmp_id[20];
24        void freetab();
25public:
26        GenoConvParam(GenoConvManager *g);
27        ~GenoConvParam();
28        void *getTarget(int);
29        const char* id(int i);
30        void updatetab();
31};
32
33class MultiMap;
34
35/// Base class for all Geno Converters.
36/// In constructor you have to set public fields
37/// indicating your identity and supported formats.
38/// Each converter serves one in-out format pair.
39/// Instance of your converter should be registered
40/// in GenoConvManager.
41class GenoConverter
42{
43public:
44        const char *name;       //< converter name (short)
45        char in_format,         //< input format, eg. '1'
46                out_format;     //< output format, eg. '0'
47        paInt enabled;  //< don't touch this! (used by configuration module)
48        paInt mapsupport; //< set to 1 if your converter supports genotype mapping
49
50        /// You have to reimplement this method.
51        /// If your converter cannot do its job, return empty string - return SString();
52        /// Any other return value is assumed to be output genotype.
53        /// @param map if not null, mapping informaton is requested, converter should add conversion map to this object
54        virtual SString convert(SString &i, MultiMap *map, bool using_checkpoints) = 0;
55
56        virtual ~GenoConverter() {}
57        /// Don't forget to set public fields in your constructor
58        GenoConverter() :name(""), in_format(-1), out_format('0'), enabled(1), mapsupport(0) {}
59};
60
61/// This class gathers abilities of all converters and can
62/// convert a genotype to any other one, provided there is
63/// a path of GenoConverters between them.
64/// In most cases you don't use this class directly,
65/// Geno::getConverted(int) provides full converting functionality.
66/// Explicit GenoConvManager object is only needed for registering
67/// your GenoConverter.
68/// Use DefaultGenoConvManager to register the standard genotype converters automatically.
69class GenoConvManager
70{
71        friend class GenoConvParam;
72        SList converters;
73public:
74        GenoConvManager();
75        ~GenoConvManager();
76        class GenoConvParam param;
77        /// make a genotype in other format. genotype will be invalid
78        /// if GenoConvManager cannot convert it.
79        Geno convert(Geno &in, char format, MultiMap *map = 0, bool using_checkpoints = false, bool *converter_missing = NULL);
80        /// register GenoConverter, the added object will be automatically deleted when GenoConvManager is destructed (call removeConverter() if this is not desirable)
81        void addConverter(GenoConverter *conv);
82        /// unregister GenoConverter
83        void removeConverter(GenoConverter *conv);
84
85        char *getPath(char in, char out, char *path, int maxlen, int *mapavailable = 0);
86        char *getFormatPath(char in, char out, char *path, int maxlen, int *mapavailable = 0);
87        /// returns the list of converters meeting the specified criteria
88        /// pass result=0 if you only need one result (by return value)
89        /// default criteria values mean "don't care", pass anything else to narrow your search
90        GenoConverter *findConverters(SListTempl<GenoConverter*>* result = 0, char in = -1, char out = -1, int enabled = -1, char* name = 0);
91};
92
93#endif
Note: See TracBrowser for help on using the repository browser.