{ "info": { "author": "Stefan Wewers, Julian R\u00fcth", "author_email": "stefan.wewers@uni-ulm.de", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Science/Research", "License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)", "Operating System :: OS Independent", "Programming Language :: Python :: 2", "Programming Language :: Python :: 3", "Topic :: Scientific/Engineering :: Mathematics" ], "description": "# MCLF\n\n[![Documentation Status](https://readthedocs.org/projects/mclf/badge/)](https://mclf.readthedocs.io/?badge=latest)\n[![CircleCI](https://circleci.com/gh/MCLF/mclf/tree/master.svg?style=svg)](https://circleci.com/gh/MCLF/mclf/tree/master)\n[![Coverage Status](https://coveralls.io/repos/github/MCLF/mclf/badge.svg?branch=master)](https://coveralls.io/github/MCLF/mclf?branch=master)\n[![asv](https://img.shields.io/badge/benchmarked%20by-asv-green.svg?style=flat)](https://mclf.github.io/mclf-asv)\n[![PyPI](https://img.shields.io/pypi/v/mclf.svg)](https://pypi.org/project/mclf/)\n\n### A Sage toolbox for computing with **M**odels of **C**urves over **L**ocal **F**ields\n\nThis is still a rather immature version of our toolbox. Nevertheless, you can\nuse it to compute, for a large class of curves over the rationals, the stable\nreduction at primes of bad reduction.\n\nLet Y be a smooth projective curve over a field K and let vK be a discrete valuation on K.\nThe principal goal is to compute the *semistable reduction* of Y with respect to vK.\nThis means that we want to know\n\n* a finite Galois extension L/K,\n* an extension vL of vK to L,\n* the special fiber of an integral semistable model of Y over the valuation\n ring of vL, and\n* the action of the decomposition group of vL on that special fiber.\n\nAt the moment we can do this only in certain special cases, which should\nnevertheless be useful.\n\nIf you have at least [Sage 8.2](https://www.sagemath.org/) you can install the\nlatest version of this package with `sage -pip install --user --upgrade mclf`.\n\nIf you can not install Sage on your local machine, you can also click\n[![Launch on mybinder.org](https://camo.githubusercontent.com/d57df63fab21897847014ebaec3e7f5f48951ad2/68747470733a2f2f626574612e6d7962696e6465722e6f72672f62616467652e737667)](https://mybinder.org/v2/gh/mclf/MCLF/master?filepath=example.ipynb)\nto run an interactive Jupyter notebook with mclf preinstalled.\n\nThe package can be loaded with\n```\nsage: from mclf import *\n```\nWe create a Picard curve over the rational number field. \n```\nsage: R. = QQ[]\nsage: Y = SuperellipticCurve(x^4-1, 3)\nsage: Y\nsuperelliptic curve y^3 = x^4 - 1 over Rational Field\n```\nIn general, the class `SuperellipticCurve` allows you to create a superelliptic curve of the form yn = f(x),\nfor a polynomial f over an arbitrary field K. But you can also define any smooth projective curve Y with given\nfunction field.\n\nWe define the 2-adic valuation on the rational field. Then we are able to create an\nobject of the class `SemistableModel` which represents a semistable model of the curve Y with respect to the 2-adic\nvaluation.\n```\nsage: v_2 = QQ.valuation(2)\nsage: Y2 = SemistableModel(Y, v_2)\nsage: Y2.is_semistable() # this may take a while\nTrue\n```\nThe stable reduction of Y at p=2 has four components, one of genus 0 and\nthree of genus 1.\n```\nsage: [Z.genus() for Z in Y2.components()]\n[0, 1, 1, 1]\nsage: Y2.components_of_positive_genus()\n[the smooth projective curve with Function field in y defined by y^3 + x^4 + x^2,\n the smooth projective curve with Function field in y defined by y^3 + x^2 + x,\n the smooth projective curve with Function field in y defined by y^3 + x^2 + x + 1]\n```\nWe can also extract some arithmetic information on the curve Y from the stable reduction.\nFor instance, we can compute the *conductor exponent* of Y at p=2:\n```\nsage: Y2.conductor_exponent()\n6\n```\nNow let us compute the semistable reduction of Y at p=3:\n```\nsage: v_3 = QQ.valuation(3)\nsage: Y3 = SemistableModel(Y, v_3)\nsage: Y3.is_semistable()\nTrue\nsage: Y3.components_of_positive_genus()\n[the smooth projective curve with Function field in y defined by y^3 + y + 2*x^4]\n```\nWe see that Y has potentially good reduction at p=3. The conductor exponent is:\n```\nsage: Y3.conductor_exponent()\n6\n```\n\nFor more details on the functionality and the restrictions of the toolbox, see the\n[Documentation](https://mclf.readthedocs.io/en/latest/).\nFor the mathematical background see\n\n* J. R\u00fcth, [Models of Curves and Valuations](https://oparu.uni-ulm.de/xmlui/handle/123456789/3302), PhD thesis, Ulm University, 2014\n* I.I. Bouw, S. Wewers, [Computing L-Functions and semistable reduction of superellipic curves](https://arxiv.org/abs/1211.4459?context=math.AG),\n Glasgow Math. J., 59(1), 2017, 77-108\n* I.I. Bouw, S. Wewers,[Semistable reduction of curves and computation of bad Euler factors of L-functions](https://www.uni-ulm.de/fileadmin/website_uni_ulm/mawi.inst.100/mitarbeiter/wewers/course_notes.pdf),\n lecture notes for a minicourse at ICERM\n* S. Wewers, Semistable reduction of superelliptic curves of degree p, preprint, 2017\n\n#### Known bugs and issues\n\nSee our [issues list](https://github.com/MCLF/mclf/issues), and tell us of any bugs or ommissions that are not covered there.\n\n#### Experimental Changes\n\nWe also have an unstable [experimental](https://github.com/MCLF/mclf/tree/experimental) version with the latest experimental features and bugs that you can try out by clicking on [![Launch on mybinder.org](https://camo.githubusercontent.com/d57df63fab21897847014ebaec3e7f5f48951ad2/68747470733a2f2f626574612e6d7962696e6465722e6f72672f62616467652e737667)](https://mybinder.org/v2/gh/mclf/MCLF/experimental?filepath=example.ipynb), note that this version currently [![CircleCI](https://circleci.com/gh/MCLF/mclf/tree/experimental.svg?style=svg)](https://circleci.com/gh/MCLF/mclf/tree/experimental) our own test suite.\n\n#### Development workflow\n\nMost development happens on feature branches against the `master` branch. The\n`master` branch is considered stable and usually we create a new release and\nupload it to PyPI whenever there is something merged into `master`. We\nsometimes collect a number of experimental changes on the `experimental`\nbranch.\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/mclf/mclf", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "mclf", "package_url": "https://pypi.org/project/mclf/", "platform": "", "project_url": "https://pypi.org/project/mclf/", "project_urls": { "Homepage": "https://github.com/mclf/mclf" }, "release_url": "https://pypi.org/project/mclf/1.0.4/", "requires_dist": [ "patchy" ], "requires_python": "", "summary": "A Sage toolbox for computing with Models of Curves over Local Fields", "version": "1.0.4" }, "last_serial": 4172820, "releases": { "1.0.1": [ { "comment_text": "", "digests": { "md5": "7d0f4c71ce207034c9ac149770172e54", "sha256": "26e4589b25c09aa017715b1b1e29638c12805c9296a3a7ffc64003247e530d49" }, "downloads": -1, "filename": "mclf-1.0.1-py2-none-any.whl", "has_sig": false, "md5_digest": "7d0f4c71ce207034c9ac149770172e54", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 123805, "upload_time": "2018-08-05T15:48:17", "url": "https://files.pythonhosted.org/packages/11/84/b0a3df17b5cf438036e51ab06418199a3c17457ff7a8bdaf64b9438b4fd3/mclf-1.0.1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4c3ae53e103f89c489c707a1005445f7", "sha256": "b36e46ed59c88bed186a84e7d66c8b62cfe628b13ed9b7e3417026cf22ee6965" }, "downloads": -1, "filename": "mclf-1.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "4c3ae53e103f89c489c707a1005445f7", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 123804, "upload_time": "2018-08-05T15:48:19", "url": "https://files.pythonhosted.org/packages/94/31/d867451e9896c26a6fc779b2e1fee93a9a8a668746d47b682fc80cc8b202/mclf-1.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "42b637d5cb5276479a230070e9d1d250", "sha256": "28ba8841bb8dbb081076e7bb353a5e663a0b2f9b2269c636908ece926b452308" }, "downloads": -1, "filename": "mclf-1.0.1.tar.gz", "has_sig": false, "md5_digest": "42b637d5cb5276479a230070e9d1d250", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 108395, "upload_time": "2018-08-05T15:48:21", "url": "https://files.pythonhosted.org/packages/80/08/499da525edde849f3a6eb00ed5892c741d7d53de3bf68260e9b841656f75/mclf-1.0.1.tar.gz" } ], "1.0.2": [ { "comment_text": "", "digests": { "md5": "75cd3eb276372d6af22f65d0b5666065", "sha256": "d90e1caa7718780293613583ae56650a46f3310704eab36073a5a4c0533745e2" }, "downloads": -1, "filename": "mclf-1.0.2-py2-none-any.whl", "has_sig": false, "md5_digest": "75cd3eb276372d6af22f65d0b5666065", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 123816, "upload_time": "2018-08-05T22:06:50", "url": "https://files.pythonhosted.org/packages/44/c8/86281863f6d39fb17dea4e75bd4a7aae2c1ab5e6735ac67c60fb47563a26/mclf-1.0.2-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "5535a1b3f600105546d7ab577ea4c208", "sha256": "08e567d58544831513eabf7f410c6e29e1104fe1efc104e1af246c4f1cb49b91" }, "downloads": -1, "filename": "mclf-1.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "5535a1b3f600105546d7ab577ea4c208", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 123816, "upload_time": "2018-08-05T22:06:52", "url": "https://files.pythonhosted.org/packages/b6/7b/895e08fd4353b2df90724f5f381c1a2ce3237901f1c65d2820ec0f25eb86/mclf-1.0.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2a35423f50ace184f323bab77fecaf45", "sha256": "8702d5995fa1f0a0cfbba5a8af9132e702b67d646b64592aa283af2e10b9a5b4" }, "downloads": -1, "filename": "mclf-1.0.2.tar.gz", "has_sig": false, "md5_digest": "2a35423f50ace184f323bab77fecaf45", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 108431, "upload_time": "2018-08-05T22:06:54", "url": "https://files.pythonhosted.org/packages/a6/8c/8c80ba95f002a1c5ed7fa808e13651041e47a1f67b40dc1e4a10432df192/mclf-1.0.2.tar.gz" } ], "1.0.3": [ { "comment_text": "", "digests": { "md5": "9e0c38ec141b740cd415168e55c88f32", "sha256": "205883d388535f553a280418fc8678f01f9ac64c3e52e808ac7cce2057281d7c" }, "downloads": -1, "filename": "mclf-1.0.3-py2-none-any.whl", "has_sig": false, "md5_digest": "9e0c38ec141b740cd415168e55c88f32", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 125097, "upload_time": "2018-08-08T21:01:31", "url": "https://files.pythonhosted.org/packages/07/c0/1bbdb45399ec971428a90ddf365efcd7c4d8e709adb0ed32e657204bc7dd/mclf-1.0.3-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "33206489caaa63ab319bc4803248fe28", "sha256": "016f42d6e7f97dd73803255b17918bb6692c7cdf6e3bba0446ad88239eaff958" }, "downloads": -1, "filename": "mclf-1.0.3-py3-none-any.whl", "has_sig": false, "md5_digest": "33206489caaa63ab319bc4803248fe28", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 125097, "upload_time": "2018-08-08T21:01:34", "url": "https://files.pythonhosted.org/packages/2e/92/c13cfba6c034f4086e5eb4f62d8b6a09a339633e1dd59efcc46d83916fe0/mclf-1.0.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ce9d7296dbe31a852e042d4abb51aebb", "sha256": "1ef0ad9091c6fa828a47c4d74f1f031ca7e08859a1cdffc3163cb440cd2f52c7" }, "downloads": -1, "filename": "mclf-1.0.3.tar.gz", "has_sig": false, "md5_digest": "ce9d7296dbe31a852e042d4abb51aebb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 109570, "upload_time": "2018-08-08T21:01:36", "url": "https://files.pythonhosted.org/packages/82/81/346ccfee275d2ce442832bdd8b8f7a1044f054037bf20373528f80d76ab7/mclf-1.0.3.tar.gz" } ], "1.0.4": [ { "comment_text": "", "digests": { "md5": "a0f0c9cd0aa95b3967e2bb284ab6c309", "sha256": "b203c22f4ae1513245a7d15026e67c5be59c70a19b94bba21a3e29f752fa52dd" }, "downloads": -1, "filename": "mclf-1.0.4-py2-none-any.whl", "has_sig": false, "md5_digest": "a0f0c9cd0aa95b3967e2bb284ab6c309", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 119236, "upload_time": "2018-08-15T11:38:45", "url": "https://files.pythonhosted.org/packages/9a/32/a7e26e51d531c1c5e357bacfffb1fd10f11a7bdd81c00b8086e9410e6003/mclf-1.0.4-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "32a0e009f1b2b4009d34540e61a34dc0", "sha256": "469e8eb6d6b3826a59b5bbaea4a91bf0f7ef54163d1a257b2d5158893a0dc559" }, "downloads": -1, "filename": "mclf-1.0.4-py3-none-any.whl", "has_sig": false, "md5_digest": "32a0e009f1b2b4009d34540e61a34dc0", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 119234, "upload_time": "2018-08-15T11:38:47", "url": "https://files.pythonhosted.org/packages/6d/b6/a7372987bfd0b52653b484d01c348dc21327c356f747e4bd510ea94e4037/mclf-1.0.4-py3-none-any.whl" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "a0f0c9cd0aa95b3967e2bb284ab6c309", "sha256": "b203c22f4ae1513245a7d15026e67c5be59c70a19b94bba21a3e29f752fa52dd" }, "downloads": -1, "filename": "mclf-1.0.4-py2-none-any.whl", "has_sig": false, "md5_digest": "a0f0c9cd0aa95b3967e2bb284ab6c309", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 119236, "upload_time": "2018-08-15T11:38:45", "url": "https://files.pythonhosted.org/packages/9a/32/a7e26e51d531c1c5e357bacfffb1fd10f11a7bdd81c00b8086e9410e6003/mclf-1.0.4-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "32a0e009f1b2b4009d34540e61a34dc0", "sha256": "469e8eb6d6b3826a59b5bbaea4a91bf0f7ef54163d1a257b2d5158893a0dc559" }, "downloads": -1, "filename": "mclf-1.0.4-py3-none-any.whl", "has_sig": false, "md5_digest": "32a0e009f1b2b4009d34540e61a34dc0", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 119234, "upload_time": "2018-08-15T11:38:47", "url": "https://files.pythonhosted.org/packages/6d/b6/a7372987bfd0b52653b484d01c348dc21327c356f747e4bd510ea94e4037/mclf-1.0.4-py3-none-any.whl" } ] }