1 package Text::Tradition::HasStemma;
7 use Text::Tradition::Stemma;
8 use Text::Tradition::StemmaUtil qw/ parse_newick /;
12 Text::Tradition::HasStemma - add-on to associate stemma hypotheses to
13 Text::Tradition objects
17 It is often the case that, for a given text tradition, the order of copying
18 of the witnesses can or should be reconstructed (or at least the attempt
19 should be made.) This class is a role that can be applied to
20 Text::Tradition objects to record stemma hypotheses. See the documentation
21 for L<Text::Tradition::Stemma> for more information.
27 Return a list of all stemmata associated with the tradition.
31 Return the number of stemma hypotheses defined for this tradition.
35 Return the L<Text::Tradition::Stemma> object identified by the given index.
39 Delete all stemma hypotheses associated with this tradition.
41 =head2 has_stemweb_jobid
43 Returns true if there is currently a Stemweb job ID, indicating that a
44 stemma tree calculation from the Stemweb service is in process.
48 Return the currently-running job ID (if any) for calculation of Stemweb
51 =head2 set_stemweb_jobid( $jobid )
53 Record a job ID for a Stemweb calculation.
59 isa => 'ArrayRef[Text::Tradition::Stemma]',
61 stemmata => 'elements',
62 _add_stemma => 'push',
64 stemma_count => 'count',
65 clear_stemmata => 'clear',
67 default => sub { [] },
70 has 'stemweb_jobid' => (
73 writer => 'set_stemweb_jobid',
74 predicate => 'has_stemweb_jobid',
75 clearer => '_clear_stemweb_jobid',
78 before 'set_stemweb_jobid' => sub {
80 if( $self->has_stemweb_jobid ) {
81 $self->throw( "Tradition already has a Stemweb jobid: "
82 . $self->stemweb_jobid );
86 =head2 add_stemma( $dotfile )
88 Initializes a Text::Tradition::Stemma object from the given dotfile,
89 and associates it with the tradition.
95 my $t = Text::Tradition->new(
96 'name' => 'simple test',
98 'file' => 't/data/simple.txt',
100 is( $t->stemma_count, 0, "No stemmas added yet" );
102 ok( $s = $t->add_stemma( dotfile => 't/data/simple.dot' ), "Added a simple stemma" );
103 is( ref( $s ), 'Text::Tradition::Stemma', "Got a stemma object returned" );
104 is( $t->stemma_count, 1, "Tradition claims to have a stemma" );
105 is( $t->stemma(0), $s, "Tradition hands back the right stemma" );
115 if( $opts{'dotfile'} ) {
116 open $stemma_fh, '<', $opts{'dotfile'}
117 or warn "Could not open file " . $opts{'dotfile'};
118 } elsif( $opts{'dot'} ) {
119 my $str = $opts{'dot'};
120 open $stemma_fh, '<', \$str;
123 binmode $stemma_fh, ':utf8';
124 my $stemma = Text::Tradition::Stemma->new(
125 'dot' => $stemma_fh );
126 $self->_add_stemma( $stemma ) if $stemma;
130 =head2 record_stemweb_result( $format, $data )
132 Records the result returned by a Stemweb calculation, and clears any
138 use JSON qw/ from_json /;
140 my $t = Text::Tradition->new(
141 'name' => 'Stemweb test',
143 'file' => 't/data/besoin.xml',
144 'stemweb_jobid' => '4',
147 is( $t->stemma_count, 0, "No stemmas added yet" );
149 my $answer = from_json( '{"status": 0, "job_id": "4", "algorithm": "RHM", "format": "newick", "start_time": "2013-10-26 10:44:14.050263", "result": "((((((((((((F,U),V),S),T1),T2),A),J),B),L),D),M),C);\n", "end_time": "2013-10-26 10:45:55.398944"}' );
150 $t->record_stemweb_result( $answer );
151 ok( !$t->has_stemweb_jobid, "Job ID was removed from tradition" );
152 is( $t->stemma_count, 1, "Tradition has new stemma" );
153 ok( $t->stemma(0)->is_undirected, "New stemma is undirected as it should be" );
154 is( $t->stemma(0)->identifier, "RHM 1382777054_0", "Stemma has correct identifier" );
161 sub record_stemweb_result {
162 my( $self, $answer ) = @_;
163 if( $answer->{format} eq 'dot' ) {
164 $self->add_stemma( dot => $answer->{result} );
165 } elsif( $answer->{format} eq 'newick' ) {
166 my $stemmata = parse_newick( $answer->{result} );
167 my $title = sprintf( "%s %d", $answer->{algorithm},
168 str2time( $answer->{start_time} ) );
170 foreach my $stemma ( @$stemmata ) {
171 my $ititle = $title . "_$i"; $i++;
172 $stemma->set_identifier( $ititle );
173 $self->_add_stemma( $stemma );
176 $self->throw( "Cannot parse tree results with format " . $answer->{format} );
178 $self->_clear_stemweb_jobid();
185 This package is free software and is provided "as is" without express
186 or implied warranty. You can redistribute it and/or modify it under
187 the same terms as Perl itself.
191 Tara L Andrews E<lt>aurum@cpan.orgE<gt>