TruxtonLocation

This class lets you add to the [Location] table in Truxton.

Attributes and Methods

altitude: float

The altitude in meters.

addnote(text: str) -> boolean

This adds an investigator's note. The text parameter is the contents of the note. It will return True if the tag was associated with the location, False on failure. The note is stored in the [InvestigatorNote] table in the database.

fileid: str

The GUID of the file this location came from. This corresponds to the [FileID] column of the [Location] table.

id: str

This is the GUID of the record. It becomes non-zero after save() has been called. This corresponds to the [ID] column of the [Location] table.

label: str

The short label for this location. This corresponds to the [Label] column of the [Location] table.

latitude: float

The latitude portion of the geographic coordinate using the WGS84 ellipsoid. This corresponds to the [Latitude] column of the [Location] table.

longitude: float

The longitude portion of the geographic coordinate using the WGS84 ellipsoid. Many thanks go to John Harrison for his work. This corresponds to the [Longitude] column of the [Location] table.

mediaid: str

This is the GUID of the media this location came from. This corresponds to the [MediaID] column of the [Location] table.

save() -> boolean

This will commit the information to the [Location] table. It will return True if the record was saved to the database, False if there was an error.

tag(tag: str, reason: str, origin: int) -> boolean

This creates a tag associated with this location in Truxton. The tag parameter is a short, one or two word, bit of text that will be displayed in the UI. The reason a sentence explaining why this location was tagged. The origin is either TAG_ORIGIN_AUTOMATIC (1) or TAG_ORIGIN_HUMAN (2). It will return True if the tag was associated with the location, False on failure.

type: int

The type of the location. This corresponds to the [LocationTypeID] column of the [Location] table. It must be a value listed in the ID column of the [LocationType] table. You can also use a predefined constant.

when: datetime

The time associated with this location. This value can be set with either a datetime value or an integer representing FILETIME ticks.

Sample

 1 import sys
 2 sys.path.append('C:/Program Files/Truxton/SDK')
 3 import truxton
 4 import shutil
 5 
 6 from datetime import datetime
 7 from calendar import timegm
 8 from pathlib import Path
 9 
10 def add_file(parent_truxton_file, filename):
11   source_file = open(filename, "rb")
12   child = parent_truxton_file.newchild()
13   child.name = Path(filename).name
14   shutil.copyfileobj(source_file, child)
15   source_file.close()
16   child.save()
17   return child
18 
19 def add_media(t):
20   media = t.newmedia()
21 
22   media.name = "Public Documents"
23   media.description = "Publicly available documents"
24   media.case = "DC-SNAFU-2016.2020"
25   media.evidencebag = "EV-0937459386623-a"
26   media.originator = "Jeffrey Jensen"
27   media.latitude = 38.897661
28   media.longitude = -77.036458
29   media.type = truxton.MEDIA_TYPE_LOGICAL_FILES
30   media.save()
31 
32   return media
33 
34 def add_cs(parent_file ):
35   child_file = add_file(parent_file, "cs.jpg")
36 
37   gps = child_file.newlocation()
38   gps.type = truxton.LOCATION_TYPE_MEETING
39   gps.latitude = 51.487329
40   gps.longitude = -0.124057
41   gps.label = "HQ"
42   gps.when = datetime.fromisoformat("2016-04-01T12:00:00-05:00")
43   gps.save()
44 
45 def main():
46   t = truxton.create()
47 
48   media = add_media(t)
49 
50   root_file = media.addroot()
51   root_file.save()
52 
53   add_cs(root_file)
54 
55 if __name__ == "__main__":
56   main()